API Documentation

ภาพรวมและการเข้าถึง

• Base URL: https://api.ranlotto.com/api/public/v1
• Public access — ไม่ต้องใช้ API key
• Rate limit: 300 requests / 5 นาที ต่อ IP (เกินได้รับ HTTP 429)
• Timezone: ทุกวันที่ใช้ Asia/Bangkok
• ปี: รองรับทั้ง ค.ศ. (เช่น 2026) และ พ.ศ. (เช่น 2569) — auto-detect หรือระบุ era=CE|BE
• Cache: GET ตอบพร้อม Cache-Control; POST /ask ไม่ถูก cache
• สเปกเต็ม: /openapi.json (OpenAPI 3.1)

Endpoints (agent)

Content API (ข่าว + บทความ)

เนื้อหาที่เผยแพร่แล้วเท่านั้น (ฉบับร่าง/ตั้งเวลา/เก็บถาวร ไม่ถูกเปิดเผย) ทุกตัวเลขผลรางวัลในบทความมาจากบริการข้อมูลกลาง ไม่ใช่ข้อความอิสระ และไม่มีถ้อยคำทำนายผล

• GET /news, GET /news/{slug} — ข่าว (ผลรางวัล/ประกาศ/อัปเดต)
• GET /blog, GET /blog/{slug} — บทความและคู่มือ
• GET /content/categories?type=news|blog, GET /content/tags
• GET /content/rss/{news|blog} — RSS · GET /content/sitemap-news — Google News sitemap
• GET /content/{slug}/cover?variant=master|og|card|square — ภาพปก (webp)
• การอ้างอิงแหล่งที่มา: ข่าวจากภายนอกเป็นบทสรุปต้นฉบับของ RANLOTTO พร้อมลิงก์ไปต้นทาง ไม่คัดลอกเนื้อหาของสำนักข่าวอื่น
• RSS: /news/rss.xml · /blog/rss.xml

Filters (query parameters)

ตัวอย่างการเรียกใช้

curl https://api.ranlotto.com/api/public/v1/lottery/number/53

curl -X POST https://api.ranlotto.com/api/public/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question":"เลข 53 ออกกี่ครั้ง"}'

Response envelope

{
  "success": true,
  "data": { "...": "..." },
  "facts": { "...": "..." },
  "statistics": { "...": "..." },
  "methodology": { "description": "...", "timezone": "Asia/Bangkok", "calculation_version": "1.0.0" },
  "limitations": ["Historical frequency does not predict future draws."],
  "sources": [{ "name": "Government Lottery Office (GLO), Thailand", "url": "https://www.glo.or.th/" }],
  "sample_size": 465,
  "filters": { "...": "..." },
  "generated_at": "2026-07-10T00:00:00.000Z",
  "timezone": "Asia/Bangkok"
}

Error: { "success": false, "error": { "code": "...", "message": "..." } }

วิธีคำนวณ ข้อจำกัด และการอ้างอิง

• ทุกสถิติคำนวณจากผล GLO ที่จัดเก็บไว้ด้วย deterministic code ไม่มีตัวเลขที่สร้างจากโมเดล
• ความถี่ย้อนหลังไม่ใช่ความน่าจะเป็นของผลในอนาคต แต่ละงวดเป็นอิสระต่อกัน
• งวดในอนาคตไม่มีข้อมูลผลรางวัลจนกว่าจะมีการประกาศจริง
• ทุกคำตอบมี sample_size, methodology, limitations และ sources กำกับ
• เอกสารเพิ่มเติมสำหรับ AI: /llms.txt · /llms-full.txt