การยืนยันตัวตนและ endpoint บัญชี

ทุกคำขอแนบ header เพียงตัวเดียว ส่วน GET /account ใช้ทดสอบว่าคีย์ใช้งานได้ ดูยอดคงเหลือในกระเป๋าเงินที่คำสั่งซื้อจะตัดไป และเช็กว่าบัญชียังเปิดใช้งานอยู่ก่อนเริ่มรันแบบชุด

วิธียืนยันตัวตนของคำขอ

เฮดเดอร์ Authorization ต้องส่งค่ายืนยันตัวตนแบบ Bearer ซึ่งประกอบด้วยรหัสคีย์และรหัสลับที่เชื่อมกันด้วยจุด ระบบใช้รหัสคีย์เพื่อระบุบัญชี แล้วตรวจรหัสลับด้วยการเปรียบเทียบแบบ HMAC หากตรวจสอบไม่สำเร็จ ระบบจะตอบกลับด้วย 401 พร้อมรหัส MISSING_API_KEY หรือ INVALID_API_KEY ก่อนที่ตัวเส้นทางจะเริ่มทำงาน นอกจากนี้ไม่มีการตรวจข้อมูลอื่นเลย ทั้งคุกกี้ โทเค็น CSRF และเฮดเดอร์ Origin

รายการ IP ที่อนุญาต

ผูกคีย์ไว้กับชุดที่อยู่ต้นทางได้ เมื่อรายการนี้ไม่ว่าง คำขอจากที่อยู่อื่นจะถูกปฏิเสธด้วย IP_NOT_ALLOWED และ HTTP 403 ก่อนการตรวจขีดจำกัดการเรียกใช้และก่อนการดึงข้อมูลกระเป๋าเงิน ข้อมูลรับรองที่ถูกขโมยไปจึงใช้นอกระบบของคุณไม่ได้ หากรายการว่าง คีย์จะใช้ได้จากทุกที่

สถานะบัญชี

มีสถานะระดับบัญชีอยู่หนึ่งอย่างที่ทำให้ทุก endpoint หยุดทันที คือบัญชีที่ถูกระงับ ซึ่งจะตอบกลับ ACCOUNT_FROZEN พร้อม HTTP 403 สถานะนี้ไม่หายไปเอง ให้ติดต่อทีมงานแทนการวนส่งคำขอซ้ำ

การหมุนเวียนคีย์

สร้างและลบคีย์ได้ที่หน้า API Access ในแผงควบคุมตัวแทนจำหน่าย Secret จะแสดงเพียงครั้งเดียวตอนสร้าง การหมุนเวียนคีย์จึงทำโดยสร้างคีย์ใหม่ นำไปใช้งาน แล้วลบคีย์เก่า แทนการแก้ไขคีย์เดิม ข้อมูลรับรองไม่หมดอายุเอง รอบการเปลี่ยนคีย์จึงขึ้นอยู่กับคุณ

GET

/account

ดูข้อมูลบัญชี

เรียกดูข้อมูลบัญชีโดยละเอียด รวมถึงยอดคงเหลือในกระเป๋าเงิน สถานะบัญชี และวันที่สร้างบัญชี

ขีดจำกัดการเรียกใช้60 คำขอ / 60 วินาที ต่อบัญชี

คำขอ

curl -s "https://shop2topup.com/api/endpoints/v1/account" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

ตัวอย่างการตอบกลับ

{
  "success": true,
  "account": {
    "id": 42,
    "email": "[email protected]",
    "username": "partner_store",
    "client_type": "reseller",
    "wallet": "1250.500000",
    "enabled": true,
    "verified": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
}

ส่งคำขอจริงจากหน้านี้

วางคีย์ API เพื่อเรียก endpoint เหล่านี้จริง คีย์จะอยู่ในแท็บเบราว์เซอร์นี้ และส่งไปที่ตัว API เท่านั้น

Enter your API key to use the interactive playground. Get your API key

เลือกเอนด์พอยต์

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

หากเพิ่งเริ่มใช้แพลตฟอร์ม เริ่มที่หน้าภาพรวม API เติมเกมสำหรับตัวแทนจำหน่าย หรืออ่านภาพรวมโปรแกรมตัวแทนจำหน่ายของ SHOP2TOPUP เพื่อดูว่าบัญชีพาร์ทเนอร์ใช้งานอย่างไร