ตัวอย่าง API ที่ใช้บ่อย

ในทุกตัวอย่างสมมติว่า $TOKEN มีแอ็กเซสโทเคนอยู่แล้ว สำหรับข้อกำหนดฉบับสมบูรณ์กรุณาดูที่ API รีเฟอเรนซ์ (Swagger)

1. ดึงรายการร้านของตนเอง

curl https://api.receiptroller.io/v1/stores \
  -H "Authorization: Bearer $TOKEN"

เรสปอนส์

{
  "object": "list",
  "data": [
    {
      "id": "str_abc123",
      "name": "渋谷店",
      "currency": "JPY",
      "created_at": "2025-12-01T00:00:00Z"
    }
  ],
  "has_more": false
}

2. ดึงใบเสร็จในช่วง 24 ชั่วโมงที่ผ่านมา

curl "https://api.receiptroller.io/v1/receipts?store_id=str_abc123&issued_after=2026-04-26T00:00:00Z&limit=50" \
  -H "Authorization: Bearer $TOKEN"

3. ดึงรายละเอียดของใบเสร็จรายใบ

curl https://api.receiptroller.io/v1/receipts/rcp_xyz789 \
  -H "Authorization: Bearer $TOKEN"

เรสปอนส์ (บางส่วน)

{
  "id": "rcp_xyz789",
  "store_id": "str_abc123",
  "issued_at": "2026-04-27T10:15:22Z",
  "total_amount": 3850,
  "tax_amount": 350,
  "currency": "JPY",
  "items": [
    {
      "product_id": "prd_a01",
      "name": "コーヒー豆 200g",
      "quantity": 1,
      "unit_price": 1500,
      "amount": 1500
    },
    {
      "product_id": "prd_a02",
      "name": "ドリッパー",
      "quantity": 1,
      "unit_price": 2000,
      "amount": 2000
    }
  ],
  "payment_method": "credit_card"
}

4. สร้างสินค้าใหม่

curl -X POST https://api.receiptroller.io/v1/products \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 01HV6N3M2K9PQR" \
  -d '{
    "store_id": "str_abc123",
    "sku": "COFFEE-200G-001",
    "name": "コーヒー豆 エチオピア 200g",
    "price": 1800,
    "currency": "JPY",
    "tax_rate": 0.10
  }'

5. อัปเดตจำนวนสต็อก

curl -X PATCH https://api.receiptroller.io/v1/inventory/prd_a01 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "quantity": 42,
    "warehouse_id": "wh_main"
  }'

6. ลงทะเบียนเอนด์พอยต์ Webhook

curl -X POST https://api.receiptroller.io/v1/webhook_endpoints \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://app.example.com/webhook",
    "events": ["receipt.issued", "receipt.refunded"],
    "description": "本番 - 在庫同期用"
  }'

7. ดึงข้อมูลผู้ใช้ของตนเอง (สโคปฝั่ง User)

curl https://api.receiptroller.io/v1/me \
  -H "Authorization: Bearer $USER_TOKEN"

※ $USER_TOKEN คือโทเคนของผู้บริโภคทั่วไปที่ได้มาด้วยสโคป user.profile

8. รายการใบเสร็จของผู้ใช้เจ้าของ (สโคปฝั่ง User)

curl "https://api.receiptroller.io/v1/me/receipts?limit=20" \
  -H "Authorization: Bearer $USER_TOKEN"

SDK แยกตามภาษา・การสร้างไคลเอนต์

เราไม่มี SDK อย่างเป็นทางการแยกตามภาษา แต่แทนที่ด้วยการเผยแพร่นิยามของเอนด์พอยต์ทั้งหมดในรูปแบบ OpenAPI (Swagger)

https://receiptroller.io/openapi/v1.json

เมื่อส่ง URL นี้ให้ AI coding assistant หรือนำเข้าเครื่องมือสร้างโค้ดอย่าง openapi-generator・NSwag・Kiota ก็จะสร้างไคลเอนต์ API ที่มีชนิด (type) อัตโนมัติได้ กรณีเขียนเองด้วยมือ ก็สามารถใช้ไลบรารีทั่วไปที่รองรับ OAuth 2.0 และ JSON HTTP (axios, Requests, HttpClient ฯลฯ) เขียนได้เลย

โค้ดตัวอย่างที่พัฒนาโดยคอมมูนิตีมีการแบ่งปันอยู่ที่ คอมมูนิตีนักพัฒนา

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

• พื้นฐานของรีเควสต์และเรสปอนส์
• รายการสโคปของ OAuth
• API รีเฟอเรนซ์ (Swagger)
• กลับไปที่ศูนย์ช่วยเหลือสำหรับนักพัฒนา