เอกสาร API
คู่มือการพัฒนาสำหรับ API รีเทลมีเดียของ ReceiptRoller
เชื่อมข้อมูลการซื้อ โฆษณา ยอดขาย สต็อก และเอกสาร เพื่อสร้างแอปสำหรับธุรกิจค้าปลีก
แคตตาล็อก API
API สำหรับทุกส่วนของแพลตฟอร์ม: การซื้อ โฆษณา CRM AI อีคอมเมิร์ซ และการดำเนินงานร้าน
กรองตามหมวดหมู่หรือกลุ่มผู้ใช้เพื่อหา API ที่ต้องการ
API ข้อมูลการซื้อ
ดึงใบเสร็จดิจิทัล ยอดขาย และประวัติการซื้อ เพื่อใช้วิเคราะห์ยอดขายและ CRM
ดูรายละเอียด →API ใบเสร็จของผู้ใช้
ดึงและบันทึกใบเสร็จของผู้ใช้ สแกนใบเสร็จด้วย AI และสรุปค่าใช้จ่ายรายเดือน
ดูรายละเอียด →API ส่งโฆษณา
ส่งโฆษณาไปยังพื้นที่โฆษณาบนป้ายดิจิทัล ใบเสร็จดิจิทัล ใบเสร็จที่พิมพ์ และแอป รวมถึงโฆษณาที่มีคูปอง
ดูรายละเอียด →API คูปองและแคมเปญ
ออก แจก และติดตามการใช้คูปอง เชื่อมกับประวัติการซื้อโดยอัตโนมัติ
ดูรายละเอียด →API ครีเอทีฟ
อัปโหลดครีเอทีฟภาพและวิดีโอ ระบบจะตรวจขนาด แนว และความยาวของแต่ละพื้นที่โฆษณาเมื่อส่ง
ดูรายละเอียด →API จัดการแคมเปญ
สร้างแคมเปญ กำหนดกลุ่มเป้าหมายตามพื้นที่ ประเภทธุรกิจ ร้าน ช่วงเวลา และสินค้าที่ซื้อ แล้วส่งตรวจ เอเจนซีดำเนินการแทนลูกค้าที่เชื่อมไว้ได้
ดูรายละเอียด →API รายงานโฆษณา
ดูยอดแสดงผล คลิก ค่าโฆษณา และการใช้คูปองรายวันและรายร้าน พร้อมยอดขายที่เพิ่มขึ้นของแต่ละแคมเปญ
ดูรายละเอียด →API ช่องคอนเทนต์
เพิ่มภาพและวิดีโอ เช่น ข่าวและสภาพอากาศ จากระบบของคุณ และแสดงบนป้ายดิจิทัลในร้าน รองรับการนำเข้าฟีดอัตโนมัติ
ดูรายละเอียด →API ลูกค้าและ CRM
ดึงคุณลักษณะลูกค้า พฤติกรรมการซื้อ และ LTV เพื่อการตลาดแบบแบ่งกลุ่ม
ดูรายละเอียด →API พยากรณ์ด้วย AI
พยากรณ์ยอดขาย ความต้องการ และการเลิกใช้ เพื่อปรับการสั่งซื้อและการส่งโฆษณาโดยอัตโนมัติ
ดูรายละเอียด →API OCR และวิเคราะห์ภาพ
อ่านใบเสร็จและภาพชั้นวางเพื่อดึงชื่อสินค้าและราคา
ดูรายละเอียด →API ชั้นวางและการจัดแสดง
ติดตามสต็อกบนชั้นวางและจำนวนหน้าสินค้า และตรวจจับสินค้าหมดโดยอัตโนมัติ
ดูรายละเอียด →API จัดการสินค้า (PIM)
ค้นหา สร้าง และอัปเดตข้อมูลหลักสินค้า การเปลี่ยนราคาจะส่งไปยัง Shopify โดยอัตโนมัติ
ดูรายละเอียด →API จัดการคำสั่งซื้อ (OMS)
ยืนยัน ดำเนินการ จัดส่ง และยกเลิกคำสั่งซื้อ และเชื่อมกับรายการขาย POS
ดูรายละเอียด →API จัดการสต็อก (WMS)
ดู ปรับ และย้ายสต็อกตามตำแหน่ง ซิงก์สต็อกกับ Shopify สองทาง
ดูรายละเอียด →API การยืนยันตัวตนและการเข้าถึง
รับโทเค็นตาม OAuth 2.0 ซึ่งเป็นพื้นฐานการเข้าถึงทุก API
ดูรายละเอียด →API การแจ้งเตือน Webhook
ส่งเหตุการณ์ เช่น การซื้อ กิจกรรมโฆษณา และการอัปเดตสต็อก ไปยังระบบภายนอกแบบเรียลไทม์
ดูรายละเอียด →API ข้อมูลหลัก
ซิงก์ข้อมูลหลักของร้าน พนักงาน และสินค้ากับระบบภายนอก และเชื่อมกับ POS และ CRM
ดูรายละเอียด →การยืนยันตัวตนและการเข้าถึง
การใช้ API ต้องยืนยันตัวตนด้วย OAuth 2.0 authorization code flow
เมื่อนักพัฒนาลงทะเบียนแอปและเจ้าของธุรกิจอนุญาตการเข้าถึง คุณจะรับโทเค็นและเรียก API ได้
GET /oauth/authorize ?client_id=YOUR_CLIENT_ID &redirect_uri=YOUR_REDIRECT_URI &response_type=code &scope=store.products.read &state=RANDOM_STATE → เจ้าของธุรกิจอนุญาตในหน้ายินยอม → redirect_uri?code=AUTH_CODE
POST /api/v1/auth/token
Content-Type: application/json
{
"grantType": "authorization_code",
"clientId": "YOUR_CLIENT_ID",
"clientSecret": "YOUR_SECRET",
"code": "AUTH_CODE",
"redirectUri": "YOUR_REDIRECT_URI"
}
→ ได้รับ accessToken + refreshToken
ส่งโทเค็นในส่วนหัวของคำขอ:
Authorization: Bearer {access_token}
ตัวอย่างคำขอ
ต่อไปนี้คือตัวอย่าง API ที่ดึงข้อมูลการซื้อ ได้ข้อมูลชื่อสินค้า ราคา ร้านที่ซื้อ และเวลาที่ซื้อ
GET /api/v1/store/receipts/{id}
Authorization: Bearer {access_token}
{
"store": "Example Store",
"total": 842,
"items": [
{ "name": "กาแฟ (M)", "price": 180 },
{ "name": "แซนด์วิช", "price": 420 }
],
"timestamp": "2025-11-11T10:32:45Z"
}
ดูทุกเอนด์พอยต์ (เอกสารอ้างอิง API)
ข้อกำหนด OpenAPI (อ่านได้ด้วยเครื่อง)
ทุกเอนด์พอยต์เผยแพร่ในรูปแบบ OpenAPI (Swagger)
ส่ง URL นี้ให้ผู้ช่วยเขียนโค้ด AI หรือเครื่องมือสร้างโค้ด เพื่อสร้าง API client แบบมีชนิดข้อมูลโดยอัตโนมัติ
https://receiptroller.io/openapi/v1.json
เชื่อมต่อแบบเรียลไทม์ด้วย Webhook
เมื่อเกิดเหตุการณ์ เช่น การซื้อหรือการคลิกโฆษณา ระบบจะแจ้ง URL ที่คุณกำหนดแบบเรียลไทม์
ใช้เชื่อมกับแอปโปรโมชันหรือระบบวิเคราะห์ภายในองค์กรโดยอัตโนมัติ
POST /webhook/purchase
{
"event": "purchase.completed",
"receipt_id": "rcp-8421093",
"total": 842,
"timestamp": "2025-11-11T10:32:45Z"
}
การสนับสนุนและติดต่อ
หากต้องการสมัครใช้ API เชื่อมต่อทางเทคนิค หรือใช้เชิงพาณิชย์ โปรดติดต่อผ่านแบบฟอร์มด้านล่าง
ไปที่แบบฟอร์มติดต่อ