เอนด์พอยต์และการกำหนดเวอร์ชัน

เบส URL

โปรดักชัน： https://api.receiptroller.io/v1
สเตจจิง： https://api-staging.receiptroller.io/v1

เอนด์พอยต์สำหรับการอนุญาต OAuth อยู่คนละโฮสต์

อนุญาต： https://receiptroller.io/oauth/authorize
โทเคน： https://receiptroller.io/oauth/token

โครงสร้าง URL

/v{เวอร์ชัน}/{รีซอร์ส}[/{ID}][/{ซับรีซอร์ส}]

ตัวอย่าง：
GET  /v1/receipts                  ← รายการใบเสร็จ
GET  /v1/receipts/rcp_xyz123       ← ใบเสร็จรายการเดียว
GET  /v1/receipts/rcp_xyz123/items ← รายละเอียดของใบเสร็จ
POST /v1/products                  ← สร้างสินค้า

นโยบายการกำหนดเวอร์ชัน

• ใช้รูปแบบระบุเวอร์ชันใน URL path（/v1/...）เราไม่ใช้รูปแบบระบุผ่านเฮดเดอร์
• การเปลี่ยนแปลงที่เข้ากันได้กับเวอร์ชันเดิม（เช่น การเพิ่มฟิลด์）จะดำเนินการภายในเวอร์ชันเดียวกัน
• การเปลี่ยนแปลงที่ทำลายความเข้ากันได้（การลบฟิลด์・เปลี่ยนชนิดข้อมูล・เปลี่ยน URL）จะให้บริการเป็นเวอร์ชันใหม่（/v2）
• หลังจากเปิดตัวเวอร์ชันใหม่ เวอร์ชันเก่าจะยังคงทำงานคู่ขนานกันเป็นเวลาอย่างน้อย 12 เดือน

การเปลี่ยนแปลงที่ถือว่าเข้ากันได้กับเวอร์ชันเดิม

• การเพิ่มฟิลด์ใหม่ในเรสปอนส์
• การเพิ่มเอนด์พอยต์ใหม่
• การเพิ่มพารามิเตอร์ริเควสต์แบบไม่บังคับ
• การเพิ่มโค้ดใหม่ในเออเรอร์โค้ดที่มีอยู่เดิม

หากตอนพัฒนาฝั่งไคลเอนต์ ออกแบบให้เพิกเฉยต่อฟิลด์ที่ไม่รู้จัก ก็จะช่วยให้รักษาความเข้ากันได้ง่ายขึ้น

ตัวอย่างการเปลี่ยนแปลงที่ทำลายความเข้ากันได้

• การลบหรือเปลี่ยนชื่อฟิลด์ที่มีอยู่เดิม
• การเปลี่ยนชนิดข้อมูลของฟิลด์（string → number เป็นต้น）
• การเพิ่มพารามิเตอร์ริเควสต์แบบบังคับ
• การเปลี่ยนวิธีการยืนยันตัวตน
• การปรับลดขีดจำกัดอัตราการเรียก (rate limit) อย่างมาก

การแจ้งยกเลิกการใช้งานและระยะเวลาสนับสนุน

การแจ้งยกเลิกจะแจ้งผ่าน "ประกาศ" ในพอร์ทัลนักพัฒนา, อีเมล และเฮดเดอร์ Sunset

การตรวจสอบเวอร์ชันปัจจุบัน

เฮดเดอร์เรสปอนส์ X-RR-Api-Version จะมีเวอร์ชันที่ประมวลผลอยู่ในปัจจุบัน

HTTP/1.1 200 OK
X-RR-Api-Version: 2026-04-01
Content-Type: application/json

คู่มือที่เกี่ยวข้อง

• พื้นฐานของริเควสต์และเรสปอนส์
• เออเรอร์โค้ดและแนวทางการรีทราย
• วิธีดู API reference และเอกสาร
• กลับไปที่หน้าช่วยเหลือสำหรับนักพัฒนา