เริ่มต้นใช้งาน

ยินดีต้อนรับสู่ Review API ตัว API ของเราออกแบบมาให้เบาที่สุดและไม่มีการเก็บข้อมูลใดๆ ในระบบของคุณ

Base URL

ส่งคำขอ API ทั้งหมดไปที่: https://api.longdo.com/review-api

การยืนยันตัวตน

เราใช้ Client ID คู่กับ Longdo API Key ในการยืนยันตัวตน โดยต้องแนบทั้งสองค่านี้ไปใน HTTP headers ของทุกคำขอ (ยกเว้นการดึงรูปภาพรีวิว)

Header	Value
X-CLIENT-ID	Client ID ของคุณ
X-API-KEY	Longdo API Key ของคุณ

ห้ามเรียก API นี้จาก frontend โดยตรง เพราะ X-API-KEY เป็นข้อมูลลับ หากโผล่ในเบราว์เซอร์ สามารถถูกขโมยไปใช้ได้ ควรเรียกผ่าน backend ของคุณเสมอ ไม่ว่าจะเป็น Node.js, Python, Go หรืออื่นๆ เป็นต้น
ในการใช้งานจริง ควรจำกัด API Key ให้ใช้ได้เฉพาะ domain หรือ IP ของ server คุณเท่านั้น อย่าตั้งเป็น * เพราะจะเปิดให้เรียกได้จากทุกที่

โควต้าการใช้งาน

สำหรับ API Key แบบฟรี จะมีโควต้าดังนี้

60 คำขอต่อนาที
5,000 คำขอต่อวัน

หากใช้เกินโควต้า API จะตอบกลับด้วย 403 Forbidden

ถ้าต้องการใช้งานมากกว่านี้ สามารถ อัปเกรด Key เพื่อปลดล็อกโควต้าได้เลย

Error ที่พบบ่อย

Status Code	ความหมาย
400	Bad Request — พารามิเตอร์ที่จำเป็นหายไป หรือส่งค่ามาไม่ถูกต้อง
401	Unauthorized — Client ID หรือ API Key ไม่ถูกต้อง
403	Forbidden — เซิร์ฟเวอร์รับคำขอได้ แต่ไม่อนุญาตให้เข้าถึง
404	Not Found — ไม่พบ endpoint หรือข้อมูลที่ร้องขอ
500	Internal Server Error — เกิดข้อผิดพลาดฝั่งของเรา

ลองเรียก API ครั้งแรก

ทดสอบดึงรีวิวของสถานที่บน Longdo Map ด้วย curl ด้านล่าง แค่เปลี่ยน {{ YOUR_CLIENT_ID }} และ {{ YOUR_API_KEY }} ตามค่าของโปรเจคและคีย์ของคุณ

curl -X 'GET' \ 
    'https://api.longdo.com/review-api/review-api/review/poi/A10000001' \ 
    -H 'X-CLIENT-ID: {{ YOUR_CLIENT_ID }}' \ 
    -H'X-API-Key: {{ YOUR_API_KEY }}' \