API · ค้นหา
สินค้าใกล้เคียง
ระเบียนที่คล้ายระเบียนหนึ่ง — ด้วยความหมายเมื่อเปิดเวกเตอร์ ด้วยคำเด่นของมันเมื่อไม่ได้เปิด
ทุกเส้นอยู่ใต้ https://api.intent-search.dev และยืนยันตัวตนด้วย Authorization: Bearer nsk_… · คีย์บอกเองว่าชุดข้อมูลไหน
เนื้อคำขอ
| ฟิลด์ | ความหมาย |
|---|---|
idต้องมีstring | number | ระเบียนที่จะหาของคล้าย |
sizenumber | 1 ถึง 50 · ค่าเริ่มต้น 10 |
filtersobject | กรองแบบเดียวกับ /v1/search |
_sourceboolean | array | แบบเดียวกับ /v1/search |
fieldsarray | ฟิลด์ข้อความที่ใช้วัดความคล้ายเมื่อใช้คำ · ค่าเริ่มต้นคือฟิลด์ที่น้ำหนักค้นหาสูงสุด (ชื่อสินค้า) |
ตัวอย่าง
curl -X POST "https://api.intent-search.dev/v1/similar" \
-H "Authorization: Bearer $NS_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "sku-1042",
"size": 5
}'คำตอบ
{
"similar_to": "sku-1042",
"by": "words",
"hits": [
{
"id": "sku-1043",
"score": 1.27,
"matched": "words",
"sort": [
1.27,
"sku-1043"
],
"document": {
"product_name": "ครีมกันแดดเนื้อบางเบา SPF50",
"brand": "Aurora",
"price": 450,
"in_stock": false
}
}
]
}สิ่งที่ควรรู้
ตัวระเบียนเองไม่อยู่ในผล · ไม่มี total และ next เพราะของคล้ายเป็นแถบสินค้า ไม่ใช่ผลค้นหาให้ไล่หน้า
by บอกว่าวัดด้วยอะไร — meaning ใช้เวกเตอร์ของระเบียนนั้นเอง words ใช้คำที่ทำให้ระเบียนนี้ต่างจากที่เหลือในชุดข้อมูล · ถ้าเปิดเวกเตอร์แล้วแต่ยังใช้ไม่ได้ (ยังสร้างไม่เสร็จ โควตาหมด) ได้ words พร้อม degraded บอกเหตุผล
วัดกับแคตตาล็อก Shopee ของลูกค้าจริง 1,451 ชิ้น: ห้าอันดับแรกอยู่หมวดเดียวกับสินค้าต้นทางเฉลี่ย 4.3 ชิ้นด้วยคำ และ 4.5 ชิ้นด้วยความหมาย
ข้อผิดพลาดของเส้นนี้
| ฟิลด์ | ความหมาย |
|---|---|
400 | ไม่มี id หรือ size นอกช่วง |
404 | ไม่มีระเบียน id นี้ |
รูปของข้อผิดพลาด อัตราต่อวินาที และการลดทอน (degraded) อยู่ที่ ข้อผิดพลาดและเพดาน
GET /v1/suggestคำแนะนำระหว่างพิมพ์