สำหรับ AI Agent
ทุกจุดเชื่อมต่อด้านล่างคือข้อมูลชุดเดียวกับที่ใช้สร้างหน้าเว็บนี้ ไม่ใช่ API แยกต่างหาก จึงไม่มีวันไม่ตรงกับหน้าเว็บ และไม่มีต้นทุนรันไทม์เพิ่ม agent ที่ทำงานแทนผู้บริโภคอ่านได้โดยไม่ต้อง scrape HTML
- ประเภทงานซ่อมบำรุง
- 19
- จังหวัดที่ครอบคลุม
- 77
| จุดเชื่อมต่อ | คำอธิบาย |
|---|---|
| /api/catalog.json | บริการที่เปิดให้บริการทั้งหมด พร้อมชื่อ 3 ภาษาและลิงก์หน้าเว็บ (ถ้ามี) |
| /api/coverage.json | จังหวัดและประเภทงานที่มีช่างขึ้นทะเบียนแล้ว ครบทุกจังหวัดที่มีข้อมูล พร้อมนโยบายพื้นที่ให้บริการของธุรกิจ |
| /api/guides.json | คู่มือซ่อมด้วยตัวเองทั้งหมด พร้อมขั้นตอน ข้อห้ามด้านความปลอดภัย จุดที่ต้องเรียกช่าง และแหล่งอ้างอิงของทุกขั้นตอน ข้อห้ามและจุดที่ต้องเรียกช่างต้องส่งต่อไปพร้อมขั้นตอนเสมอ ห้ามตัดออก |
/api/services/{serviceKey}.json | รายละเอียดบริการเดียว: ช่วงราคาอ้างอิง ปัจจัยราคา คำถามที่พบบ่อย แยกตามภาษาที่มีข้อมูลจริง (ดู locales) ไม่มีการสลับภาษาแทนกัน พร้อม commitments (ระยะประกัน เวลาตอบกลับ การรับประกันซ่อมซ้ำ) เมื่อเจ้าของธุรกิจกำหนดไว้จริง |
| /openapi.json | เอกสาร OpenAPI 3.1 ของจุดเชื่อมต่อทั้งหมดด้านบน |
| /.well-known/agent.json | บัตรความสามารถของ agent แบบมาตรฐาน — สรุปทุกจุดเชื่อมต่อและขอบเขตการเขียนข้อมูลในไฟล์เดียว |
ขอบเขตการเขียนข้อมูล
จุดเชื่อมต่อทั้งหมดด้านล่างเป็นแบบอ่านอย่างเดียวและไม่ต้องยืนยันตัวตน วันนี้ยังไม่มี endpoint สาธารณะสำหรับ "ส่งงานแทนลูกค้า" หาก agent ต้องการส่งงานให้ลูกค้าจริง ต้องขอลิงก์ยืนยันตัวตนแบบเซ็นชื่อ (signed hand-off link) แล้วให้ลูกค้าคนนั้นกดยืนยันเองในแอป ระบบพันธมิตร (partner) ที่ต้องการเชื่อมต่อเชิงเขียนข้อมูลใช้ bearer token ผ่าน MCP endpoint ที่ออกให้เป็นรายกรณี ไม่ใช่จุดเชื่อมต่อในเอกสารนี้
ราคาที่แสดงคืออะไร
ตัวเลข priceBands ใน /api/services/{serviceKey}.json เป็นช่วงราคาอ้างอิงตลาดของงานประเภทนั้น ไม่ใช่ใบเสนอราคา ราคาที่ต้องจ่ายจริงคือยอดในใบเสนอราคาของช่าง ซึ่งตั้งจากรายละเอียดที่ลูกค้าส่งมา และลูกค้ายืนยันก่อนนัดเข้าหน้างาน ทุก response มีฟิลด์ priceDisclaimer ระบุไว้ในตัวข้อมูลเอง เพื่อไม่ให้คำเตือนนี้ตกหล่นเมื่อ agent ดึงตัวเลขไปบอกลูกค้า
ตัวอย่างเรียกใช้งาน
curl https://f-fix.com/api/catalog.json
curl https://f-fix.com/api/coverage.json
curl https://f-fix.com/api/services/air_conditioning.json
curl https://f-fix.com/openapi.json
curl https://f-fix.com/.well-known/agent.json