Guida all'integrazione

Autenticati, cerca e leggi i risultati.

1. Autenticazione

Chiama dal tuo server con chiave API e intestazioni Content-Type: application/json. Mantieni la tua chiave privata.

Apri le chiavi API

2. Richiedi parametri

Le richieste supportano solo query, conteggio e search_lang. la query accetta una domanda o parole chiave in linguaggio naturale.

CampoTipoNecessarioDescrizione
querystringSÌUna domanda di ricerca o parole chiave. Non deve essere vuoto.
countintegerNOConteggio dei risultati desiderati. Omettere o passare 0 per utilizzare l'impostazione predefinita del servizio.

4. Leggi il risultato

Controlla prima il successo. In caso di successo, leggere data.references e data.data; in caso di errore, controllare errorCode e errorMsg. Il contenuto web riportato di seguito è illustrativo.

Risposta di successo
json
{
  "success": true,
  "data": {
    "references": [
      {
        "website": "example.com",
        "logo": "https://example.com/favicon.ico",
        "title": "Esempio di notizie sulla casa intelligente",
        "url": "https://example.com/article",
        "summary": "Il riepilogo dei risultati della ricerca va qui.",
        "published": "",
        "extra": {}
      }
    ],
    "data": [
      "Il riepilogo dei risultati della ricerca va qui."
    ]
  },
  "errorCode": null,
  "errorMsg": null
}
data.referencesRiferimenti web con titoli, collegamenti e riepiloghi.
data.dataElenco di testi dei risultati, nidificato all'interno dell'oggetto dati esterno.
references[].website / logoNome del sito web o dominio e logo URL.
references[].title / url / summaryTitolo del risultato, pagina originale URL e riepilogo.
references[].published / extraData di pubblicazione e informazioni aggiuntive. Potrebbe essere vuoto.

success=true con riferimenti e array di dati vuoti significa che non sono stati trovati risultati validi. Prova parole chiave diverse o una lingua di ricerca diversa; non trattarlo come un guasto API.

Risposta all'errore
json
{
  "success": false,
  "data": null,
  "errorCode": "PARAM_INVALID",
  "errorMsg": "query is required"
}

Errori comuni e passaggi successivi

PARAM_INVALIDOControllare JSON e interrogare. Correggere i parametri prima di riprovare.
RICERCA_FAILEDLa ricerca è fallita. Riprova più tardi con un limite di tentativi. Per gli errori persistenti, risparmia il tempo della chiamata e richiedi l'identificatore per il supporto.