API H2H Integration

เอกสารฉบับสมบูรณ์สำหรับการเชื่อมต่อระบบอัตโนมัติ

เอกสารนี้สำหรับพาร์ทเนอร์ ตัวแทนจำหน่าย และนักพัฒนาที่ต้องการเชื่อมต่อระบบกับ TokoGue โดยตรง

Base URL

https://api.tokogue.com/api

Format

JSON Request / Response

ภาพรวม

ภาพรวมรูปแบบการเชื่อมต่อ H2H สำหรับระบบ TokoGue

รูปแบบการเข้าถึงปัจจุบัน

ใช้ X-API-KEY สำหรับ API ทั่วไป และ JWT token สำหรับธุรกรรมพาร์ทเนอร์/สมาชิก

รูปแบบการเชื่อมต่อที่แนะนำ

เข้าสู่ระบบพาร์ทเนอร์ ซิงค์แคตตาล็อก สร้างคำสั่งซื้อ และติดตามสถานะจนเสร็จสิ้น

การยืนยันตัวตน

เฮดเดอร์ขั้นต่ำที่จำเป็นสำหรับการส่งคำขอ

เฮดเดอร์ endpoint สาธารณะ / แคตตาล็อก

Content-Type: application/json
Accept: application/json
X-API-KEY: YOUR_GLOBAL_API_KEY

เฮดเดอร์ endpoint ธุรกรรมพาร์ทเนอร์

Content-Type: application/json
Accept: application/json
X-API-KEY: YOUR_GLOBAL_API_KEY
Authorization: Bearer YOUR_JWT_TOKEN

ขั้นตอนการเชื่อมต่อ

ขั้นตอนทางเทคนิคที่แนะนำเพื่อให้ระบบพาร์ทเนอร์เสถียร

1. Login

เข้าสู่ระบบบัญชีพาร์ทเนอร์เพื่อรับ JWT token

2. Config

ตั้งค่า IP whitelist และ callback URL ในบัญชีพาร์ทเนอร์

3. Sync

ดึงข้อมูลเกม สินค้า รายการราคา และโปรโมชั่น

4. Validation

ตรวจสอบภูมิภาคหรือชื่อเล่นในเกมเมื่อจำเป็น

5. Order

ส่งธุรกรรมอัตโนมัติไปยัง endpoint คำสั่งซื้อ

6. Polling

ติดตามธุรกรรมจนถึงสถานะสุดท้าย

ซิงค์สินค้า

Endpoint สำหรับดึงแคตตาล็อกและตรวจสอบสินค้า

GET/api/games

ดึงรายการเกม

GET/api/games/{slug}

ดึงรายละเอียดเกมและสินค้า

GET/api/price-list

ซิงค์ราคาสินค้า

GET/api/promo

ดึงโปรโมชั่นหรือแฟลชเซลที่กำลังใช้งาน

POST/api/mlbb/check-region

ตรวจสอบข้อมูลเกมก่อนสร้างคำสั่งซื้อ

ธุรกรรม

Endpoint หลักสำหรับสร้างธุรกรรมอัตโนมัติจากระบบพาร์ทเนอร์

POST/api/orders

สร้างคำสั่งซื้ออัตโนมัติจากระบบพาร์ทเนอร์

ตรวจสอบสถานะ

Endpoint สำหรับติดตามธุรกรรมหลังสร้างคำสั่งซื้อ

GET/api/orders/{orderId}

ตรวจสอบรายละเอียดคำสั่งซื้อด้วยเลขอ้างอิง

GET/api/transactions

ดึงประวัติธุรกรรมบัญชีพาร์ทเนอร์

GET/api/transaction-summary

ดึงสรุปธุรกรรมบัญชีพาร์ทเนอร์

การตั้งค่าพาร์ทเนอร์

Endpoint สำหรับบัญชีพาร์ทเนอร์และการตั้งค่า H2H

POST/api/auth/login

เข้าสู่ระบบบัญชีพาร์ทเนอร์และรับ JWT

GET/api/auth/user

ตรวจสอบ token เข้าสู่ระบบ

GET/api/member/profile

ดู API key, IP whitelist และ callback URL ของสมาชิก

PUT/api/member/api-config

บันทึก IP whitelist และ callback URL

POST/api/member/api-key/reset

รีเซ็ต API key ของบัญชีสมาชิก

ตัวอย่างคำขอ

ตัวอย่างขั้นต่ำที่ใช้ในการเชื่อมต่อ H2H

เข้าสู่ระบบพาร์ทเนอร์

curl -X POST "https://api.tokogue.com/api/auth/login" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_GLOBAL_API_KEY" \
  -d '{
    "email": "partner@tokogue.com",
    "password": "your-password"
  }'

สร้างคำสั่งซื้อ

curl -X POST "https://api.tokogue.com/api/orders" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_GLOBAL_API_KEY" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "games": "mobile-legends",
    "id_games": "12345678",
    "server_games": "1234",
    "product": "86 Diamonds",
    "nominal": "86 Diamonds",
    "price": 22000,
    "payment_name": "Saldo",
    "payment_code": "SALDO"
  }'

ตรวจสอบสถานะคำสั่งซื้อ

curl -X GET "https://api.tokogue.com/api/orders/INV-EXAMPLE-12345" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_GLOBAL_API_KEY"

หมายเหตุสำคัญ

หมายเหตุเพื่อป้องกันความเข้าใจผิดระหว่างการใช้งาน

ฟิลด์ api_key, api_whitelist_ips และ callback_url มีในบัญชีสมาชิกและบันทึกผ่าน backend ได้

ใน backend ปัจจุบัน ยังไม่ได้ใช้ IP whitelist ตรวจสอบคำขอ และยังไม่ได้ใช้ callback URL ส่งสถานะไปยัง endpoint พาร์ทเนอร์

รูปแบบที่แนะนำคือ H2H แบบ JWT: เข้าสู่ระบบพาร์ทเนอร์ เก็บ token ส่งคำสั่งซื้อ และ polling สถานะจนเสร็จ

หากเพิ่มการตรวจสอบ IP whitelist หรือ outbound callback เอกสารนี้สามารถขยายได้โดยไม่เปลี่ยนขั้นตอนหลักของคำสั่งซื้อ