Skip to content

game.queryList ​

This interface is implemented by the platform application (APP) server and called by the SUD OpenPaaS server.

Query the online game list (paginated). Aligned with ThirdPartyPlatformGameInfo core fields; reference: helloOP GET /developer/game/list.

Invocation method:

  • HTTPS call

HTTPS Call ​

http
POST {query_game_list_webhook}

Request Parameters - Header ​

PropertyTypeDefaultRequiredDescription
AuthorizationstringYesFormat: Bearer {access_token}

Request Parameters - Body ​

PropertyTypeDefaultRequiredDescription
page_noint1NoPage number, starting from 1
page_sizeint20NoPage size

Return Value ​

Object ​

Returned JSON packet

PropertyTypeDescription
ret_codeinteger0 success, non-zero failure
ret_msgstring"success" or error reason
dataobjectBusiness body (when ret_code=0; empty list is [])
data.listarrayGame list
data.list[].bundle_idstringPackage name (key for detail / KYC / ICP pull)
data.list[].namestringGame name
data.list[].versionstringLatest version
data.totallongTotal count
data.page_nointegerCurrent page
data.page_sizeintegerPage size
timestamplongMillisecond timestamp

Valid values of ret_code ​

ValueDescriptionMin version
0Success
40001invalid access_token

cURL Request ​

bash
curl -X POST \
  {query_game_list_webhook} \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json; charset=utf-8' \
  -d '{
  "page_no": 1,
  "page_size": 20
}'

Success Response ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "list": [
      {
        "bundle_id": "com.example.game.demo",
        "name": "Demo Game",
        "version": "1.0.0"
      }
    ],
    "total": 1,
    "page_no": 1,
    "page_size": 20
  },
  "timestamp": 1719820800000
}

Error Response ​

json
{
  "ret_code": 40001,
  "ret_msg": "invalid access_token"
}