Entegrasyon kılavuzu

Kimlik doğrulaması yapın, arayın ve sonuçları okuyun.

1. Kimlik doğrulama

API-key ve Content-Type: application/json başlıkları ile sunucunuzdan çağrı yapın. Anahtarınızı gizli tutun.

API Anahtarlarını Aç

2. Parametreleri talep et

İstekler yalnızca sorgulamayı, sayımı ve search_lang'yi destekler. sorgu doğal dildeki bir soruyu veya anahtar kelimeleri kabul eder.

AlanTürGerekliTanım
querystringEvetBir arama sorusu veya anahtar kelimeler. Boş olmamalıdır.
countintegerHAYIRİstenilen sonuç sayısı. Hizmet varsayılanını kullanmak için 0'yi atlayın veya iletin.

4. Sonucu okuyun

Önce başarıyı kontrol edin. Başarılı olduğunuzda data.references ve data.data'yı okuyun; arıza durumunda errorCode ve errorMsg'yi inceleyin. Aşağıdaki web içeriği örnek niteliğindedir.

Başarı yanıtı
json
{
  "success": true,
  "data": {
    "references": [
      {
        "website": "example.com",
        "logo": "https://example.com/favicon.ico",
        "title": "Örnek akıllı ev haberleri",
        "url": "https://example.com/article",
        "summary": "Arama sonucu özeti buraya gelir.",
        "published": "",
        "extra": {}
      }
    ],
    "data": [
      "Arama sonucu özeti buraya gelir."
    ]
  },
  "errorCode": null,
  "errorMsg": null
}
data.referencesBaşlıklar, bağlantılar ve özetler içeren web referansları.
data.dataDış veri nesnesinin içine yerleştirilmiş sonuç metin listesi.
references[].website / logoWeb sitesi adı veya etki alanı ve logosu URL.
references[].title / url / summarySonuç başlığı, orijinal sayfa URL ve özet.
references[].published / extraYayın tarihi ve ek bilgiler. Boş olabilir.

Boş referanslara ve veri dizilerine sahip success=true, geçerli bir sonuç bulunmadığı anlamına gelir. Farklı anahtar kelimeleri veya farklı bir arama dilini deneyin; bunu bir API arızası olarak değerlendirmeyin.

Hata yanıtı
json
{
  "success": false,
  "data": null,
  "errorCode": "PARAM_INVALID",
  "errorMsg": "query is required"
}

Yaygın hatalar ve sonraki adımlar

PARAM_INVALIDJSON'yi kontrol edin ve sorgulayın. Tekrar denemeden önce parametreleri düzeltin.
SEARCH_FAILEDArama başarısız oldu. Daha sonra deneme sayısı sınırıyla yeniden deneyin. Kalıcı arızalar için çağrı süresini kaydedin ve destek için tanımlayıcı isteyin.