Conventions

Shared rules that apply to every member-API endpoint — read this page once and the endpoint pages only need to cover what is specific to each route

Base URL and versioning

BASE_URL is per environment — provided by the best-system team
Every endpoint lives under the /api/v1 prefix (URI versioning — the current version is v1)

text

https://api.example.com/api/v1/games/providers
└──────── BASE_URL ───────┘└─ prefix ─┘└─ endpoint ─┘

Every endpoint returns the same JSON shape, on success and on error — write your parser once and reuse it everywhere

json

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": { "revoked": true },
  "request_uuid": "9f2b7d1e-4a83-4c1f-b2ce-6d5a0e8f3c21"
}

Field	Type	Meaning
`success`	boolean	`true` on success (paired with `code = 0`) · `false` on error
`code`	number	BusinessCode — `0` = success, anything else is a business result code (one catalog across the whole system)
`message`	string	Human-readable text for `code` — language follows `x-lang` (default th)
`data`	object · array · null	The endpoint's payload · always `null` on error
`request_uuid`	string	Request id — echoes `X-Request-Id` if sent, otherwise server-generated