คู่มือบูรณาการ

ตรวจสอบสิทธิ์ ค้นหา และอ่านผลลัพธ์

1. การรับรองความถูกต้อง

โทรจากเซิร์ฟเวอร์ของคุณด้วยส่วนหัว api-key และ Content-Type: application/json เก็บกุญแจของคุณไว้เป็นส่วนตัว

เปิดคีย์ API

2. ขอพารามิเตอร์

คำขอรองรับเฉพาะการสืบค้น การนับ และ search_lang แบบสอบถามยอมรับคำถามหรือคำหลักที่เป็นภาษาธรรมชาติ

สนามชนิดข้อมูลที่จำเป็นคำอธิบาย
querystringใช่คำถามค้นหาหรือคำสำคัญ ต้องไม่ว่างเปล่า
countintegerเลขที่จำนวนผลลัพธ์ที่ต้องการ ละเว้นหรือส่งผ่าน 0 เพื่อใช้ค่าเริ่มต้นของบริการ

4. อ่านผลลัพธ์

ตรวจสอบความสำเร็จก่อน เมื่อประสบความสำเร็จ ให้อ่าน data.references และ data.data หากเกิดความล้มเหลว ให้ตรวจสอบ errorCode และ errorMsg เนื้อหาเว็บด้านล่างนี้เป็นเพียงภาพประกอบ

การตอบสนองที่ประสบความสำเร็จ
json
{
  "success": true,
  "data": {
    "references": [
      {
        "website": "example.com",
        "logo": "https://example.com/favicon.ico",
        "title": "ตัวอย่างข่าวสมาร์ทโฮม",
        "url": "https://example.com/article",
        "summary": "สรุปผลการค้นหาอยู่ที่นี่",
        "published": "",
        "extra": {}
      }
    ],
    "data": [
      "สรุปผลการค้นหาอยู่ที่นี่"
    ]
  },
  "errorCode": null,
  "errorMsg": null
}
data.referencesการอ้างอิงเว็บพร้อมชื่อเรื่อง ลิงก์ และบทสรุป
data.dataรายการข้อความผลลัพธ์ที่ซ้อนอยู่ภายในออบเจ็กต์ข้อมูลภายนอก
references[].website / logoชื่อเว็บไซต์หรือโดเมนและโลโก้ URL
references[].title / url / summaryชื่อผลลัพธ์ หน้าต้นฉบับ URL และสรุป
references[].published / extraวันที่ตีพิมพ์และข้อมูลเพิ่มเติม อาจจะว่างเปล่า

success=true ที่มีการอ้างอิงว่างและอาร์เรย์ข้อมูล หมายความว่าไม่พบผลลัพธ์ที่ถูกต้อง ลองใช้คำหลักอื่นหรือภาษาการค้นหาอื่น อย่าถือว่ามันเป็นความล้มเหลว API

การตอบสนองข้อผิดพลาด
json
{
  "success": false,
  "data": null,
  "errorCode": "PARAM_INVALID",
  "errorMsg": "query is required"
}

ข้อผิดพลาดทั่วไปและขั้นตอนถัดไป

PARAM_INVALIDตรวจสอบ JSON และสอบถาม แก้ไขพารามิเตอร์ก่อนลองอีกครั้ง
ค้นหา_ล้มเหลวการค้นหาล้มเหลว ลองอีกครั้งในภายหลังโดยจำกัดจำนวนครั้ง สำหรับความล้มเหลวอย่างต่อเนื่อง โปรดประหยัดเวลาในการโทรและขอตัวระบุเพื่อรับการสนับสนุน