คู่มือ API สมัครขอใช้งาน
📍 Traffy Fondue Open Data & Exchange API

เชื่อมต่อและแลกเปลี่ยนข้อมูลปัญหาเมือง อย่างไร้รอยต่อ

แพลตฟอร์ม API มาตรฐานสำหรับหน่วยงานภาครัฐ อปท. รัฐวิสาหกิจ และผู้พัฒนาระบบภายนอก ในการรับ-ส่งข้อมูลเรื่องแจ้งเหตุ จัดการสถานะ และรับข้อมูลแบบ Real-time

สมัครขอใช้งาน (Google Form) เข้าสู่คู่มือ API
14 Core API Endpoints
3 Real-time Webhooks
JWT Bearer Security
REST / JSON Standard Format
Integration Modes

3 รูปแบบการเชื่อมต่อระบบ

รูปแบบการรับส่งข้อมูลที่มีให้บริการ

1. ส่งข้อมูลเข้า Fondue

ระบบของท่าน ส่งเรื่องแจ้งใหม่หรือการอัปเดต เข้ามาในระบบ Traffy Fondue

  • new-issue ส่งเรื่องแจ้งใหม่พร้อมพิกัดและรูป
  • update-issue อัปเดตสถานะและแนบรูปผลงาน
  • star บันทึกคะแนนความพึงพอใจ
  • comment ส่งข้อความแชต/SMS ถึงผู้แจ้ง
  • join-forward เชิญร่วม & ส่งต่อเคส
  • หมายเหตุ: ทุก API จำเป็นต้องใช้ Bearer token ที่ได้มาจาก API get-auth

2. ขอข้อมูลจาก Fondue

ระบบของท่าน ดึงรายการเรื่องแจ้ง พิกัด ภาพถ่าย และข้อมูลโครงสร้างหน่วยงานไปแสดงผลบน Dashboard หรือระบบภายในของท่าน

  • get-issues ดึงรายการเรื่องแจ้งพร้อมตัวกรอง
  • get-issue ดึงประวัติและข้อมูลเชิงลึกรายเคส
  • download-issues Export ข้อมูลเป็น CSV
  • get-org-list ขอผังโครงสร้างหน่วยงาน
  • get-type-list ขอรายการประเภทปัญหา
  • get-status-list ขอรายการสถานะ
  • หมายเหตุ: ทุก API จำเป็นต้องใช้ Bearer token ที่ได้มาจาก API get-auth

3. Real-time Webhooks

ระบบ Traffy Fondue ส่งข้อมูลเรื่องแจ้งใหม่ หรือการอัปเดต หรือข้อความแชท ไปยัง Server ปลายทางของท่านทันทีเมื่อมีเหตุการณ์เกิดขึ้น โดยไม่หักโควต้า

  • New Issue [POST] ส่งข้อมูลเรื่องแจ้งไปให้เมื่อมีเคสใหม่เข้ามา
  • Status Update [PATCH] ส่งข้อมูลการอัปเดตไปให้เมื่อมีการอัปเดต
  • Chat [POST] ส่งข้อความแชทไปให้เมื่อมีข้อความแชท
  • หมายเหตุ:
    1. Non-quota การส่งนี้จะไม่นับโควต้า Credit Balance
    2. จะไม่ส่งกิจกรรมที่ได้รับเข้ามาทาง Exchange ทุก account เพื่อป้องกันการเกิด echo loop
Getting Started

ขั้นตอนการขอใช้งาน API

เริ่มต้นเชื่อมต่อกับ Traffy Fondue Exchange API ง่ายๆ ใน 4 ขั้นตอน

1

กรอกแบบฟอร์ม

ลงทะเบียนข้อมูลหน่วยงานและผู้ประสานงานผ่าน Google Form เพื่อขอเปิดบัญชี Exchange API

2

รับข้อมูลทางอีเมล

ทีมงานจะส่ง Username, Password, โควต้าการใช้งาน และเอกสารการใช้งาน ให้ทางอีเมลที่ระบุ

3

ขอรับ JWT Token

นำ Username & Password ไปเรียก API /get-auth/v1 เพื่อรับ Bearer Token

4

เริ่มเชื่อมต่อ API

นำ Token ที่ได้รับ มาใส่ใน Header Authorization: Bearer แล้วเรียกใช้ API ที่ต้องการได้ทันที

Developer Documentation

คู่มือการเชื่อมต่อ API ฉบับเต็ม

รวมเอกสารสเปกครบ ทุก Endpoints และ ทุก Real-time Webhooks พร้อมประเภทตัวแปร (Data Types), ตัวอย่างคำสั่ง cURL, ตัวอย่าง JSON Response และ OpenAPI Spec (.yaml)

เปิดคู่มือ API สมัครขอใช้งาน
⚠️
Terms of Use & Legal Disclaimer

ข้อกำหนดการใช้งานและข้อสงวนสิทธิ์ความรับผิดชอบเกี่ยวกับข้อมูล

Traffy Fondue เป็นเพียงแพลตฟอร์มผู้ให้บริการระบบ (Platform Service Provider) เท่านั้น: มิได้เป็นผู้ผลิต สร้างสรรค์ ควบคุม หรือรับรองความถูกต้องของเนื้อหา ข้อมูล ภาพถ่าย หรือพิกัดใดๆ ในระบบ โดยความรับผิดชอบตามกฎหมายทั้งหมดเกี่ยวกับเนื้อหาจะตกอยู่กับ เจ้าของเรื่องแจ้ง, เจ้าหน้าที่และหน่วยงานผู้รับผิดชอบ, และ ผู้นำข้อมูลไปใช้ต่อ โดยตรง ทางผู้พัฒนาและผู้ให้บริการแพลตฟอร์ม (NECTEC/สวทช.) ขอปฏิเสธความรับผิด (Disclaimer of Liability) ในกรณีเกิดข้อพิพาทหรือการฟ้องร้องดำเนินคดีใดๆ ทั้งสิ้น

🚨 คำเตือนสำคัญสำหรับผู้ใช้งานผ่านระบบ Exchange API: ข้อมูลที่ดึงจากระบบเป็น "ข้อมูลดิบที่ไม่ผ่านการเซนเซอร์ (Uncensored)" ขอให้ระมัดระวังการเผยแพร่ข้อมูลออกสู่สาธารณะให้มากที่สุด และต้องปฏิบัติตาม พ.ร.บ. คุ้มครองข้อมูลส่วนบุคคล (PDPA) อย่างเคร่งครัด โดยต้องเบลอภาพหรือตัดทอนข้อมูลส่วนบุคคล ก่อนการเผยแพร่สู่สาธารณะ

ต้องการความช่วยเหลือหรือขอเพิ่มโควต้า?

หากโควต้าประจำเดือนใกล้หมด หรือต้องการปรึกษาการออกแบบและเชื่อมต่อระบบ สามารถติดต่อทีมงาน Traffy Fondue ได้ตลอดเวลาทำการ

สมัครขอใช้งาน API LINE: @fonduehelp