API · ตั้งค่า
ตั้งหน้าเว็บที่ใช้ client key ได้
PUT/v1/originsคีย์ service
แทนที่รายชื่อ origin ทั้งหมดด้วยรายการนี้
ทุกเส้นอยู่ใต้ https://api.intent-search.dev และยืนยันตัวตนด้วย Authorization: Bearer nsk_… · คีย์บอกเองว่าชุดข้อมูลไหน
เนื้อคำขอ
| ฟิลด์ | ความหมาย |
|---|---|
originsต้องมีarray | origin คือ scheme + host + port ถ้ามี เช่น https://shop.example.com หรือ http://localhost:3000 · https://*.example.com คือทุก subdomain · http://localhost:* คือทุกพอร์ตบนเครื่องนี้ สำหรับ dev server ระหว่างพัฒนา — :* ใช้ได้กับ localhost 127.0.0.1 และ [::1] เท่านั้น · ไม่เกิน 100 รายการ · รายการว่างคือไม่มีหน้าเว็บไหนใช้ client key ได้ |
ตัวอย่าง
curl -X PUT "https://api.intent-search.dev/v1/origins" \
-H "Authorization: Bearer $NS_KEY" \
-H "Content-Type: application/json" \
-d '{
"origins": [
"https://shop.example.com",
"http://localhost:*"
]
}'คำตอบ
{
"origins": [
"https://shop.example.com",
"http://localhost:*"
]
}สิ่งที่ควรรู้
ทั้งรายการในครั้งเดียว ส่งรายการเดิมซ้ำได้โดยไม่มีอะไรเปลี่ยน · มีผลกับคำขอถัดไปทันที
http://localhost:3000 กับ http://127.0.0.1:3000 เป็นคนละ origin และ http://localhost:* ก็ไม่ครอบ 127.0.0.1 ใส่ให้ตรงกับที่อยู่ในแถบที่อยู่ของเบราว์เซอร์
ถ้ามีรายการไหนไม่ใช่ origin จะได้ 400 ที่บอกว่ารายการไหน และรายชื่อเดิมไม่เปลี่ยน
ข้อผิดพลาดของเส้นนี้
| ฟิลด์ | ความหมาย |
|---|---|
400 | รายการที่ไม่ใช่ origin รวมถึง :* หลังโฮสต์อื่นนอกจาก localhost 127.0.0.1 [::1] · เกิน 100 รายการ |
403 | ใช้ client key |
รูปของข้อผิดพลาด อัตราต่อวินาที และการลดทอน (degraded) อยู่ที่ ข้อผิดพลาดและเพดาน
GET /v1/vectorsสถานะการค้นด้วยความหมาย