Guide d'intégration

Authentifiez-vous, recherchez et lisez les résultats.

1. Authentification

Appelez depuis votre serveur avec la clé API et les en-têtes Content-Type : application/json. Gardez votre clé privée.

Ouvrir les clés API

2. Paramètres de la demande

Les requêtes prennent uniquement en charge les requêtes, les nombres et search_lang. La requête accepte une question ou des mots-clés en langage naturel.

ChampTypeRequisDescription
querystringOuiUne question de recherche ou des mots-clés. Ne doit pas être vide.
countintegerNonNombre de résultats souhaités. Omettez ou transmettez 0 pour utiliser la valeur par défaut du service.

4. Lire le résultat

Vérifiez d'abord le succès. En cas de succès, lisez data.references et data.data ; en cas d'échec, inspectez errorCode et errorMsg. Le contenu Web ci-dessous est illustratif.

Réponse réussie
json
{
  "success": true,
  "data": {
    "references": [
      {
        "website": "example.com",
        "logo": "https://example.com/favicon.ico",
        "title": "Exemple d'actualités sur la maison intelligente",
        "url": "https://example.com/article",
        "summary": "Le résumé des résultats de la recherche se trouve ici.",
        "published": "",
        "extra": {}
      }
    ],
    "data": [
      "Le résumé des résultats de la recherche se trouve ici."
    ]
  },
  "errorCode": null,
  "errorMsg": null
}
data.referencesRéférences Web avec titres, liens et résumés.
data.dataListe de textes de résultat, imbriquée dans l'objet de données externe.
references[].website / logoNom ou domaine du site Web et logo URL.
references[].title / url / summaryTitre du résultat, page originale URL et résumé.
references[].published / extraDate de publication et informations supplémentaires. Peut-être vide.

success=true avec des références et des tableaux de données vides signifie qu'aucun résultat valide n'a été trouvé. Essayez différents mots-clés ou une autre langue de recherche ; ne le traitez pas comme un échec API.

Réponse à l'erreur
json
{
  "success": false,
  "data": null,
  "errorCode": "PARAM_INVALID",
  "errorMsg": "query is required"
}

Erreurs courantes et étapes suivantes

PARAM_INVALIDVérifiez le JSON et interrogez. Corrigez les paramètres avant de réessayer.
SEARCH_FAILEDLa recherche a échoué. Réessayez plus tard en limitant le nombre de tentatives. En cas d'échecs persistants, enregistrez l'heure de l'appel et demandez l'identifiant pour l'assistance.