Integrationsleitfaden

Authentifizieren, suchen und die Ergebnisse lesen.

1. Authentifizierung

Rufen Sie von Ihrem Server mit API-Schlüssel und Content-Type: application/json-Headern auf. Halten Sie Ihren Schlüssel geheim.

Öffnen Sie die API-Schlüssel

E 2. Parameter anfordern

Anfragen unterstützen nur Abfrage, Anzahl und search_lang. Die Abfrage akzeptiert eine Frage oder Schlüsselwörter in natürlicher Sprache.

FeldTypErforderlichBeschreibung
querystringJaEine Suchfrage oder Schlüsselwörter. Darf nicht leer sein.
countintegerNEINGewünschte Ergebnisanzahl. Lassen Sie 0 weg oder übergeben Sie es, um den Dienststandard zu verwenden.

4. Lesen Sie das Ergebnis

Überprüfen Sie zunächst den Erfolg. Bei Erfolg lesen Sie data.references und data.data; Überprüfen Sie bei einem Fehler errorCode und errorMsg. Der folgende Webinhalt dient der Veranschaulichung.

Erfolgsantwort
json
{
  "success": true,
  "data": {
    "references": [
      {
        "website": "example.com",
        "logo": "https://example.com/favicon.ico",
        "title": "Beispielhafte Smart-Home-Neuigkeiten",
        "url": "https://example.com/article",
        "summary": "Die Zusammenfassung der Suchergebnisse finden Sie hier.",
        "published": "",
        "extra": {}
      }
    ],
    "data": [
      "Die Zusammenfassung der Suchergebnisse finden Sie hier."
    ]
  },
  "errorCode": null,
  "errorMsg": null
}
data.referencesWebreferenzen mit Titeln, Links und Zusammenfassungen.
data.dataErgebnistextliste, verschachtelt im äußeren Datenobjekt.
references[].website / logoName oder Domain der Website und Logo URL.
references[].title / url / summaryErgebnistitel, Originalseite URL und Zusammenfassung.
references[].published / extraVeröffentlichungsdatum und zusätzliche Informationen. Kann leer sein.

success=true mit leeren Referenzen und Datenarrays bedeutet, dass keine gültigen Ergebnisse gefunden wurden. Probieren Sie andere Schlüsselwörter oder eine andere Suchsprache aus; Behandeln Sie es nicht als API-Fehler.

Fehlerreaktion
json
{
  "success": false,
  "data": null,
  "errorCode": "PARAM_INVALID",
  "errorMsg": "query is required"
}

Häufige Fehler und nächste Schritte

PARAM_INVALIDÜberprüfen Sie JSON und fragen Sie ab. Korrigieren Sie die Parameter, bevor Sie es erneut versuchen.
SEARCH_FAILEDDie Suche ist fehlgeschlagen. Versuchen Sie es später erneut, wobei die Anzahl der Versuche begrenzt ist. Speichern Sie bei anhaltenden Fehlern die Anrufzeit und die Anforderungskennung für den Support.