Community API Explorer

ทดลองเรียก API

เลือกหมวดแล้วกดทดลอง

สัญญา API

ส่ง X-Team-ID: team-01 ทุกคำขอ ข้อมูลของแต่ละ Team ID แยกกัน ควรใช้ชื่อกลุ่มที่ตกลงกับอาจารย์ (นี่ไม่ใช่ระบบยืนยันตัวตน)

GET    /api/v1/{domain}/{resource}?page=1&limit=10&search=คำค้น&status=active
GET    /api/v1/{domain}/{resource}/{id}
POST   /api/v1/{domain}/{resource}
PATCH  /api/v1/{domain}/{resource}/{id}
DELETE /api/v1/{domain}/{resource}/{id}

POST และ PATCH ส่ง JSON object ที่มี title เป็นข้อความไม่ว่าง พร้อมฟิลด์เพิ่มเติมได้ตามแอป โดย id และ created_at จัดการโดย server

{ "title": "กิจกรรมชุมชน", "status": "active", "description": "รายละเอียด" }

รายการสำเร็จ: {"data":[...],"meta":{"total":12,"page":1,"limit":10}}
รายละเอียด/เพิ่ม/แก้ไข: {"data":{...}}
ลบ: {"data":{"id":"...","deleted":true}}
ข้อผิดพลาด: {"error":{"code":"...","message":"..."}}

ฟิลด์ร่วม: id, title, description, status, created_at, category, location, contact, image_url, image_kind, is_synthetic, related ส่วนฟิลด์เฉพาะ เช่น scientific_name, watering_interval_days, pm25, quantity_needed, price_per_kg_thb ดูได้เมื่อเลือก API ด้านบน สถานะของแต่ละ resource แตกต่างกัน ควรตรวจจากตัวอย่าง ไม่จำกัดเฉพาะ active/pending/completed

image_url เป็นเส้นทางภาพประกอบ SVG บน server เดียวกัน ให้ resolve กับ API base URL ก่อนแสดงในแอป รูปเหล่านี้เป็นภาพวาดประกอบ ไม่ใช่ภาพถ่ายสถานที่หรือบุคคลจริง
related มีเฉพาะความสัมพันธ์ที่มีความหมาย พร้อม foreign key เช่น tree_id หรือ patient_id ดู mapping ได้จาก schema ของแต่ละ API
ข้อมูลเริ่มต้น 12 รายการต่อ collection · limit สูงสุด 100 · API เก็บการเปลี่ยนแปลงใน SQLite · PATCH เปลี่ยนเฉพาะฟิลด์ที่ส่งมา และต้องมี title

สถานการณ์ทดสอบ

success, empty, server_error (500), unauthorized (401), rate_limit (429 พร้อม Retry-After), slow, wrong_type, missing_field, invalid_json

ตรวจ X-Request-ID และ X-Scenario เพื่ออ้างอิงกับอาจารย์ • empty, wrong_type, missing_field และ invalid_json จะไม่บันทึกการเปลี่ยนแปลง • slow หน่วงก่อนทำงานปกติ • Random สุ่มทั้งกรณีสำเร็จและผิดพลาด ส่วน Failed Only สุ่ม 401/429/500/JSON เสีย

Catalog, schema และหน้าเอกสารไม่ถูกจำลองข้อผิดพลาด อ่าน schema พร้อมตัวอย่างได้ที่ /api/v1/catalog/{domain}/{resource} ซึ่งไม่ต้องส่ง X-Team-ID
Catalog นี้และหน้าเอกสารไม่ถูกจำลองข้อผิดพลาด การตั้งค่าจำลองอยู่ฝั่งอาจารย์ นักศึกษาเปลี่ยนผ่าน query string ไม่ได้