Panduan integrasi

Otentikasi, cari, dan baca hasilnya.

1. Otentikasi

Panggilan dari server Anda dengan api-key dan header Content-Type: application/json. Jaga kerahasiaan kunci Anda.

Buka Kunci API

2. Parameter permintaan

Permintaan hanya mendukung kueri, penghitungan, dan search_lang. kueri menerima pertanyaan atau kata kunci bahasa alami.

BidangTipeDiperlukanKeterangan
querystringYaPertanyaan pencarian atau kata kunci. Tidak boleh kosong.
countintegerTIDAKJumlah hasil yang diinginkan. Hilangkan atau teruskan 0 untuk menggunakan layanan default.

4. Baca hasilnya

Periksa kesuksesan terlebih dahulu. Jika berhasil, baca data.references dan data.data; jika gagal, periksa errorCode dan errorMsg. Konten web di bawah ini adalah ilustrasi.

Respon sukses
json
{
  "success": true,
  "data": {
    "references": [
      {
        "website": "example.com",
        "logo": "https://example.com/favicon.ico",
        "title": "Contoh berita rumah pintar",
        "url": "https://example.com/article",
        "summary": "Ringkasan hasil pencarian ada di sini.",
        "published": "",
        "extra": {}
      }
    ],
    "data": [
      "Ringkasan hasil pencarian ada di sini."
    ]
  },
  "errorCode": null,
  "errorMsg": null
}
data.referencesReferensi web dengan judul, tautan, dan ringkasan.
data.dataDaftar teks hasil, bersarang di dalam objek data luar.
references[].website / logoNama situs web atau domain dan logo URL.
references[].title / url / summaryJudul hasil, halaman asli URL dan ringkasan.
references[].published / extraTanggal publikasi dan informasi tambahan. Mungkin kosong.

success=true dengan referensi kosong dan array data berarti tidak ditemukan hasil yang valid. Coba kata kunci lain atau bahasa pencarian lain; jangan memperlakukannya sebagai kegagalan API.

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

Kesalahan umum dan langkah selanjutnya

PARAM_INVALIDPeriksa JSON dan tanyakan. Perbaiki parameter sebelum mencoba lagi.
SEARCH_FAILEDPencarian gagal. Coba lagi nanti dengan batasan percobaan. Untuk kegagalan yang terus-menerus, hemat waktu panggilan dan minta pengidentifikasi untuk dukungan.