CNX ODP API Reference

CNX ODP API เป็น REST API ที่ตอบกลับเป็น JSON ทั้งหมด รองรับเฉพาะการเชื่อมต่อผ่าน HTTPS ทุก request ต้องแนบ API key และทุก response จะมีเวลาที่ข้อมูลถูกตรวจสอบล่าสุดกำกับไว้เสมอ

ปรัชญาของ API ชุดนี้คือ ข้อมูลชุดเดียวที่ทั้งเมืองอ้างอิงร่วมกัน ผู้ประกอบการอัปเดตครั้งเดียวผ่าน LINE OA แล้วทุกแพลตฟอร์มที่เชื่อมต่ออยู่จะเห็นข้อมูลชุดเดียวกันทันที

curl https://api.hommuang.com/v1/venues/cnx-odp-0042 \
  -H "Authorization: Bearer $CNX_ODP_KEY"

ทุก endpoint อยู่ภายใต้ base URL เดียว เวอร์ชันระบุอยู่ใน path เพื่อให้การอัปเกรดไม่กระทบระบบที่ใช้งานอยู่

https://api.hommuang.com/v1

เมื่อ v1 ขึ้นสถานะ GA เราจะประกาศนโยบาย deprecation ล่วงหน้าอย่างน้อยหนึ่งรอบก่อนปิดเวอร์ชันเก่า

ยืนยันตัวตนด้วย Bearer token ในเฮดเดอร์ Authorization request ที่ไม่มี key หรือใช้ key ที่ถูกเพิกถอนแล้วจะได้รับ 401

Authorization: Bearer pk_cnx_live_7f3a9c2e1b8d4056

โควตาคิดตามแพ็กเกจที่ใช้งาน ทุก response จะแนบเฮดเดอร์บอกโควตาคงเหลือกลับมาด้วยเสมอ

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1785225600

เมื่อเกินโควตา API จะตอบ 429 Too Many Requests พร้อมเฮดเดอร์ Retry-After เป็นจำนวนวินาที แนะนำให้ทำ exponential backoff ฝั่ง client

ทุก resource มี ID ที่คงที่ตลอดอายุการใช้งาน ไม่เปลี่ยนแม้ผู้ประกอบการจะแก้ชื่อร้าน ย้ายที่ตั้ง หรือเปลี่ยนเจ้าของ และจะไม่ถูกนำกลับมาใช้ซ้ำ คุณจึงใช้เป็น key ในการ cache ฝั่งคุณได้อย่างปลอดภัย

cnx-odp-0042
└── prefix ─┘└ sequence

# ตัวอย่างอื่น
cnx-bus-r3          # เส้นทางขนส่ง
cnx-odp-0117        # สถานที่

โครงสร้างหลักของแพลตฟอร์ม อ็อบเจกต์ mice คือส่วนที่ทำให้ CNX ODP ต่างจากผู้ให้บริการแผนที่ทั่วไป

Event object

แต่ละรายการใน events คืองานที่ยืนยันแล้วของสถานที่นั้น lead_time_days คือระยะห่างระหว่าง วันที่ยืนยันการจอง กับวันจัดงาน — ไม่ใช่จำนวนวันนับจากวันนี้ ค่าจึงคงที่ตลอดอายุของ record และใช้เทียบข้ามสถานที่ได้ บอกได้ว่าสถานที่ไหนต้องจองล่วงหน้านานแค่ไหน

{
  "id": "cnx-odp-0042",
  "name": "ขันโตกล้านนา เฮือนเพ็ญ",
  "district": "เมืองเชียงใหม่",
  "mice_summary": {
    "tax_invoice": "full_form",
    "max_pax_one_bill": 200,
    "halal_sets_capacity": 200,
    "coach_parking_slots": 3
  },
  "mice_profile": "/v1/venues/cnx-odp-0042/mice",
  "events": [
    { "type": "forum", "date": "2026-09-18", "lead_time_days": 62 }
  ],
  "verified_at": "2026-07-21T09:14+07:00",
  "source": "CNX ODP · Hommuang"
}

นี่คือส่วนที่ทำให้ CNX ODP มีเหตุผลจะมีอยู่ ผู้จัดงานไมซ์ใช้เงินองค์กร เกณฑ์คัดสถานที่จึงไม่ใช่ “อาหารอร่อยไหม” แต่เป็น “วางบิลบริษัทได้ไหม จอดรถโค้ชได้กี่คัน ทำฮาลาลได้กี่เซ็ต” — คำถามที่ต้องโทรถามทีละร้าน เพราะไม่มีฐานข้อมูลไหนเก็บไว้

ทุกฟิลด์ในกลุ่มนี้ออกแบบเป็น ตัวเลขและเงื่อนไข ไม่ใช่ค่า true/false เพราะ “มีฮาลาล” ไม่ช่วยคนที่ต้องเลี้ยง 200 คน แต่ halal_sets_capacity: 200 ช่วย

group_capability

ความสามารถระดับกรุ๊ป เป็นตัวเลข ไม่ใช่ช่วงกว้าง ๆ

finance_docs

กลุ่มที่ตัดสินว่าสถานที่จะได้งานหรือไม่ ถ้าออกใบกำกับภาษีเต็มรูปไม่ได้ ฝ่ายจัดซื้อตัดออกทันทีไม่ว่าอาหารจะดีแค่ไหน

coach_logistics

รถโค้ชคือข้อจำกัดจริงของงานกรุ๊ป ร้านที่ดีแต่รถเข้าไม่ได้ก็ใช้งานไม่ได้

dietary_capacity

ไม่ใช่ “มีเมนูฮาลาล” แต่เป็นทำได้กี่เซ็ต และต้องแจ้งล่วงหน้าเท่าไหร่

staff_standards

ภาษาที่พนักงานใช้ได้จริง และมาตรฐานที่ผ่านการรับรอง

ชุด endpoint สำหรับ v1 — ทุกตัวรองรับเฉพาะ GET เพราะ CNX ODP เป็นแหล่งข้อมูลอ่านอย่างเดียวสำหรับ Distributor การแก้ไขข้อมูลเกิดขึ้นฝั่งผู้ประกอบการผ่าน LINE OA เท่านั้น

curl -G https://api.hommuang.com/v1/venues \
  -H "Authorization: Bearer $CNX_ODP_KEY" \
  -d "tax_invoice=full_form" \
  -d "halal_sets_capacity=gte:150" \
  -d "coach_parking_slots=gte:2"

API ใช้รหัสสถานะ HTTP ตามมาตรฐาน และแนบ error object ที่อ่านเข้าใจได้กลับมาใน body เสมอ

{
  "error": {
    "code": "venue_not_found",
    "message": "No venue matches id cnx-odp-9999",
    "status": 404,
    "request_id": "req_8f2c1a7e"
  }
}

แนบ request_id มาด้วยทุกครั้งที่แจ้งปัญหา จะช่วยให้ทีมเราไล่ log ได้ตรงจุด

แทนที่จะ poll เพื่อเช็คว่าข้อมูลเปลี่ยนหรือยัง ให้ CNX ODP ส่ง event มาหาคุณเมื่อข้อมูลถูกอัปเดตหรือตรวจสอบใหม่ นี่คือกลไกที่ทำให้ปลายทางของคุณสดใหม่ตามต้นทางโดยไม่เปลืองโควตา

{
  "event": "venue.verified",
  "venue_id": "cnx-odp-0042",
  "verified_by": "LFFintech Local Service",
  "occurred_at": "2026-07-21T09:14+07:00"
}