FOR HUMANS & AI AGENTS · อัปเดต 2026-10-04
Developer Document
ข้อมูลชุดเดียวกับหน้าเว็บ เปิดผ่าน REST API (16 resource) และ MCP (17 tools) ทั้งหมดอ่านอย่างเดียว ไม่ต้องสมัครหรือใช้กุญแจ
ความสามารถที่เปิดให้ใช้
| กลุ่ม | ข้อมูล | REST | MCP |
|---|---|---|---|
| Brief | สรุปประจำวัน 06:00 พร้อมช่วงข้อมูลและความครบถ้วน | /briefs | get_today_brief / get_brief_by_date |
| Brief | อัปเดตที่เข้ามาหลังตัดรอบ Brief (แก้ไข/ถอน/ข้อมูลมาช้า) | /brief-updates | — |
| Signals | การเปลี่ยนแปลงที่ผ่านเกณฑ์ทางการ (ทุกระดับ) | /signals | list_signals / get_signal |
| Signals | เหตุการณ์แบบมีเวอร์ชัน (active/withdrawn) | /events | list_signal_events |
| Data | ค่าตัวเลขที่เก็บได้จริง พร้อมวันที่อ้างอิง/มีผล/ได้รับ | /observations | get_observations |
| Data | ค่าเขื่อนรายชั่วโมงที่กระทบกรุงเทพฯ | /dams | get_dam_levels |
| Data | สถานีตรวจอากาศกรมอุตุฯ ใกล้กรุงเทพฯ (ราย 3 ชม./7 วัน) | /weather | get_weather_observations |
| Data | ผลสลากที่ยืนยันแล้ว ใหม่สุดก่อน | /lottery | get_latest_lottery |
| Sources | ทะเบียนแหล่งข้อมูล เจ้าของ ช่องทาง ใบอนุญาต รอบอัปเดต | /sources | list_sources |
| Sources | ผลการดึงข้อมูลแต่ละรอบ (30 วัน) พร้อมเหตุผลที่ล้มเหลว | /source-health | get_source_health |
| Sources | metadata ของไฟล์หลักฐานดิบ (ไม่มีไฟล์/ที่เก็บ) | /evidence | get_evidence_metadata |
| Context | โพสต์ FM91 / BTS / MRT — บริบทเท่านั้น | /social | list_social_updates |
| Context | ข่าว RSS ที่ติดแท็ก + ข่าวทั่วไป — บริบทเท่านั้น | /news | list_news_mentions |
| Calendar | วันหยุดราชการ/ธนาคาร | /holidays | get_calendar |
| Calendar | กำหนดยื่นภาษี (กรมสรรพากร) | /tax-deadlines | get_calendar |
| Calendar | กำหนดเผยแพร่ข้อมูลทางการ | /calendar | get_calendar |
เริ่มต้นเร็ว
curl 'https://thailands-daily-pulse.lovable.app/api/public/v1/signals?limit=10'
curl 'https://thailands-daily-pulse.lovable.app/api/public/v1/observations?id=lpg&limit=5'รายละเอียด parameter, field และตัวอย่าง: REST API · เชื่อม AI: MCP · สำหรับ LLM: /llms.txt
ข้อจำกัด
- GET เท่านั้น สูงสุด 100 รายการต่อคำขอ (ค่าเริ่มต้น 25) เรียงใหม่สุดก่อน
- จำกัด 120 คำขอ/นาที/IP — เกินจะได้ 429 พร้อม
Retry-After: 60 - CORS เปิดทุก origin, cache 60 วินาที (health ไม่ cache)
- ไม่มีคำสั่งดึงข้อมูล, เผยแพร่ Brief, backfill, คิวงาน หรือการตั้งค่า
- หลักฐานดิบเปิดเฉพาะ metadata (url, sha256, ขนาด) ไม่มีไฟล์หรือลิงก์ดาวน์โหลด
- ข่าวและ Social เป็นบริบท ไม่สร้างและไม่เพิ่มคะแนน Signal
วงจรรายวัน (เวลา Asia/Bangkok)
00:00–05:45
ช่วงข้อมูลของ Brief ดึงรอบเร่ง 00:10 / 03:00 / 05:00 / 05:30
05:45
ตัดรอบ (freeze) — ข้อมูลที่ received_at หลังนี้ไม่เข้า Brief
05:55
เผยแพร่ Brief (ลองซ้ำ 05:58) หลังเผยแพร่แล้วไม่แก้
หลังเผยแพร่
การแก้ไข/ถอน/ข้อมูลมาช้า ไปอยู่ที่ /brief-updates
ระดับสัญญาณ
highสำคัญมาก- — เกินเกณฑ์ทางการ ≥ 3 เท่า หรือข้าม ≥ 2 ระดับ
mediumน่าจับตา- — เกินเกณฑ์ ≥ 1.5 เท่า
lowเล็กน้อย- — ผ่านเกณฑ์ขั้นต่ำ เก็บในประวัติ แต่หน้า “วันนี้” ไม่แสดง
กฎที่ผ่านอยู่ใน checks และคะแนนจัดอันดับใน score (severity × z × ความน่าเชื่อถือ × reach × หลักฐาน) — เกณฑ์เป็นค่าทางการ ผู้อ่านตั้งเองไม่ได้
เวอร์ชัน การถอน และข้อมูลมาช้า
event_id=metric_id:YYYY-MM-DDมีเวอร์ชันใหม่เมื่อเนื้อหาเปลี่ยนเท่านั้นstatus=withdrawnเมื่อข้อมูลแก้แล้วไม่ผ่านเกณฑ์- ข้อมูลที่มาช้าแต่ผ่านเกณฑ์ เก็บวันที่ข้อมูลเดิม แสดงในวันที่มาถึง
checks.arrival_rule = "late_above_threshold" - ไม่มีการเติมวันที่ขาดหาย ช่องว่างคือช่องว่าง
ความหมายของเวลาและคุณภาพ
observed_on / period_start–end- วันที่ที่ข้อมูลกล่าวถึง
effective_from- วันที่ราคา/ค่าเริ่มมีผลจริงตามต้นทาง (เช่น ก๊าซหุงต้ม 2023-03-01)
published_at- เวลาที่ต้นทางเผยแพร่ (ถ้าระบุ)
received_at- เวลาที่ระบบได้รับ ใช้ตัดรอบ 05:45 และไม่ถูกเขียนทับเมื่อค่าไม่เปลี่ยน
evidence_id- อ้างอิงไฟล์หลักฐานดิบที่ใช้ (ดู /evidence)
is_demo / is_live- แยกข้อมูลตัวอย่างออกจากข้อมูลจริง
เวลาทั้งหมดเป็น ISO 8601 (UTC) ส่วนวันที่ (date) เป็นวันตามปฏิทินกรุงเทพฯ
ประวัติการเปลี่ยนแปลง
- 2026-10-04 — เอกสารสร้างจากสเปกเดียวกับ API; ระบุ
date/idราย endpoint;/signals?id=กรองmetric_id(เดิมเกิด 500); MCPget_signalคืน event + versions,get_household_impactอ่านจาก signal versions; OpenAPI 1.1 มี field, 429 และ /health - 1.0 — เปิด REST v1, OpenAPI 3.1 และ MCP 17 tools