API · ข้อมูล
ส่งที่พักไว้เข้าดัชนี
ส่งทุกอย่างที่เขียนหรือลบไว้และยังไม่ถึงดัชนี ในครั้งเดียว
ทุกเส้นอยู่ใต้ https://api.intent-search.dev และยืนยันตัวตนด้วย Authorization: Bearer nsk_… · คีย์บอกเองว่าชุดข้อมูลไหน
ตัวอย่าง
curl -X POST "https://api.intent-search.dev/v1/sync" \
-H "Authorization: Bearer $NS_KEY" \
-H "Content-Type: application/json" \
-d '{}'คำตอบ
{
"sent": 3,
"deleted": 0,
"reregistered": false
}สิ่งที่ควรรู้
sent นับเฉพาะระเบียนที่ใหม่หรือเปลี่ยนตั้งแต่ sync ครั้งก่อน — ส่งไฟล์เดิม 1,451 แถวซ้ำโดยแก้ไป 114 แถว sync จะได้ sent: 114 ไม่ใช่ข้อมูลหาย
รอบที่ล้มเหลวตอบ 502 พร้อมเหตุผล ไม่ใช่ 200 · ของที่พักไว้ไม่หายไปไหน เรียกซ้ำได้ทันที
reregistered เป็น true เฉพาะเมื่อเอนจินลืมชุดข้อมูลนี้ไป (ดิสก์ถูกสร้างใหม่ สแนปช็อตเก่า) แล้วระบบประกาศมันใหม่และส่งทุกระเบียนให้เอง — เป็นการกู้คืน ไม่ใช่ข้อผิดพลาด
ของที่แก้จากคอนโซล (ลบ กู้คืน อัปโหลดไฟล์) ถูกส่งให้เองภายในราวหนึ่งนาทีหลังหยุดแก้ แต่ของที่ส่งผ่าน /v1 รอให้คุณเรียกเส้นนี้เสมอ — ระบบไม่มีวันเอาไฟล์ที่ backend ของคุณส่งยังไม่จบขึ้นร้าน
ข้อผิดพลาดของเส้นนี้
| ฟิลด์ | ความหมาย |
|---|---|
402 | แพ็กเกจนี้ใช้พื้นที่เกินเพดานแล้ว |
502 | เอนจินรับไม่สำเร็จ — ไม่มีอะไรหาย เรียกซ้ำได้ |
รูปของข้อผิดพลาด อัตราต่อวินาที และการลดทอน (degraded) อยู่ที่ ข้อผิดพลาดและเพดาน
POST /v1/searchค้นหา