External API สำหรับจัดการ Member และตรวจสอบรายการ

สรุปภาษาไทย

• ✅ หน้านี้ครอบคลุม 4 route: สร้าง Member, แก้ไข Member, สรุปธุรกรรมเกม และรายการโอน Wallet
• ✅ ตาราง Request/Response ใช้ชื่อ field และชนิดข้อมูลจาก Gateway controller กับ generated protobuf
• ⚠️ ต้องส่ง apikey ผ่าน API-key middleware; ห้ามใส่ credential จริงในเอกสารหรือตัวอย่าง
• ⚠️ ทุก route เป็นร่างสำหรับ contract ที่ base SHA; ตรวจสอบการเปิดใช้งานจริงก่อนนำไปใช้

สร้างผู้ใช้ประเภท Member ผ่าน body แบบ JSON โดย controller กำหนด user_type=Member และส่ง status=Normal ไปยัง core เสมอ ค่า auth_name มาจาก API-key principal ของผู้เรียก ไม่ใช่ body field

Request

Response

cURL

curl --request POST 'https://api.example.invalid/v2/external/users' \
  --header 'apikey: [REDACTED]' \
  --header 'content-type: application/json' \
  --data '{"username":"member-001","password":"[REDACTED]","confirm_password":"[REDACTED]","first_name":"Audit","last_name":"Member","shard_ids":["1"]}'

ตัวอย่าง Response สำเร็จ

{
  "status": {"code": 200, "message": "OK"},
  "message": {"code": "gwmsg02", "message": "Success"},
  "data": {"user_data": {"users": [{"username": "member-001", "user_type": "Member", "status": "Normal"}]}}
}

ตัวอย่าง Response ผิดพลาด

{
  "status": {"code": 400, "message": "Bad Request"},
  "message": {"code": "gwer1", "message": "invalid request body"}
}

แก้ไขเฉพาะค่าที่ส่งมาใน body ของ Member ที่ระบุด้วย username โดย username เป็น field เดียวที่จำเป็น ส่วนอีก 11 field เป็น optional และค่าที่ไม่ส่งจะไม่ถูกเปลี่ยนแปลง auth_name ถูกสร้างจาก API-key principal ฝั่ง server จึง caller ไม่สามารถส่งเป็น body field ได้

⚠️ เบอร์โทรศัพท์ (phone_number) แก้ไขผ่านเส้นนี้ไม่ได้ เพราะ core request message ไม่มี field นี้

Request

Response

cURL

curl --request POST 'https://api.example.invalid/v2/external/users/update' \
  --header 'apikey: [REDACTED]' \
  --header 'content-type: application/json' \
  --data '{"username":"member-001","first_name":"Updated","clear_token_after_login":true}'

ตัวอย่าง Response สำเร็จ

{
  "status": {"code": 200, "message": "OK"},
  "message": {"code": "gwmsg02", "message": "Success"},
  "data": {"user_data": {"users": [{"username": "member-001", "first_name": "Updated", "clear_token_after_login": true}]}}
}

ตัวอย่าง Response ผิดพลาด

{
  "status": {"code": 400, "message": "Bad Request"},
  "message": {"code": "gwer1", "message": "invalid request body"}
}

อ่านสรุปธุรกรรมเกมของผู้ใช้ โดยเลือกกรองด้วย username, game_id, game_list_id, round_id และช่วงเวลา start_date_unix/end_date_unix หากไม่ส่งค่าจำนวนเต็มเวลา controller ใช้ค่า 0; ค่า parse ไม่ได้ตอบ HTTP 500

Request

Response

cURL

curl --get 'https://api.example.invalid/v2/external/game/summary_transaction' \
  --data-urlencode 'username=member-001' \
  --data-urlencode 'start_date_unix=1787011200' \
  --data-urlencode 'end_date_unix=1787097600' \
  -H 'apikey: [REDACTED]'

ตัวอย่าง Response สำเร็จ

{
  "status": {"code": 200, "message": "OK"},
  "message": {"code": "gwmsg02", "message": "Success"},
  "data": [{"user_id": "user-001", "user_name": "member-001", "game_type_summary": [{"game_type": "slots", "bet_amount": 100, "win_amount": 125.5, "refund_amount": 0, "turnover_amount": 100, "transaction_count": 4}], "summary_amount": {"bet_amount": 100, "win_amount": 125.5, "refund_amount": 0, "turnover_amount": 100}}]
}

ตัวอย่าง Response ผิดพลาด

{
  "status": {"code": 500, "message": "Internal Server Error"},
  "message": {"code": "gwer1", "message": "invalid integer query parameter"}
}

อ่านรายการ transfer ของ Member โดยใช้ offset pagination จาก from และ size เลือกทิศทางด้วย direction ซึ่งรองรับ in, out และ all (ค่าว่างเท่ากับ all) ค่าเวลาเป็น Unix seconds และค่าว่างใช้ 0

Request

Response

cURL

curl --get 'https://api.example.invalid/v2/external/wallet/transfers' \
  --data-urlencode 'username=member-001' \
  --data-urlencode 'direction=in' \
  --data-urlencode 'start_date=1787011200' \
  --data-urlencode 'end_date=1787097600' \
  --data-urlencode 'from=0' \
  --data-urlencode 'size=100' \
  -H 'apikey: [REDACTED]'

ตัวอย่าง Response สำเร็จ

{
  "status": {"code": 200, "message": "OK"},
  "message": {"code": "gwmsg02", "message": "Success"},
  "rows": [{"id": "transfer-row-1", "transaction_time_ns": 1787097600000000000, "ref_code": "audit-ref-1", "username": "member-001", "type_name": "transfer", "type_sub_name": "up", "amount": 25.5, "amount_before": 100, "amount_after": 125.5, "asset_name": "USD", "asset_unit": "USD", "note": "audit example"}]
}

ตัวอย่าง Response ผิดพลาด

{
  "status": {"code": 400, "message": "Bad Request"},
  "message": {"code": "gwer1", "message": "invalid direction or integer query parameter"}
}