Skip to content

game.queryDetail ​

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

Query game basic information by package name (excluding operating regions). Aligned with ThirdPartyPlatformGameInfo; reference: helloOP GET /developer/game/basic-info.

Invocation method:

  • HTTPS call

HTTPS Call ​

http
POST {query_game_detail_webhook}

Request Parameters - Header ​

PropertyTypeDefaultRequiredDescription
AuthorizationstringYesFormat: Bearer {access_token}

Request Parameters - Body ​

PropertyTypeDefaultRequiredDescription
bundle_idstringYesPackage name from game.queryList

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)
data.bundle_idstringPackage name
data.namestringGame name
data.iconstringGame icon (first item of icon set; empty if none)
data.versionstringLatest version
data.enginestringGame engine
data.first_categorystringPrimary category
data.second_categorystringSecondary category
data.min_agestringAge rating
data.special_mechanismstringSpecial mechanism
data.introductionstringShort introduction
data.descriptionstringDetailed description
data.service_phonestringSupport phone
data.service_emailstringSupport email
data.service_privacystringPrivacy policy URL
timestamplongMillisecond timestamp

Valid values of ret_code ​

ValueDescriptionMin version
0Success
40001invalid access_token
40003game not found

cURL Request ​

bash
curl -X POST \
  {query_game_detail_webhook} \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json; charset=utf-8' \
  -d '{
  "bundle_id": "com.example.game.demo"
}'

Success Response ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "bundle_id": "com.example.game.demo",
    "name": "Demo Game",
    "icon": "https://cdn.example.com/icon.png",
    "version": "1.0.0",
    "engine": "Unity",
    "first_category": "Casual",
    "second_category": "Puzzle",
    "min_age": "8+",
    "special_mechanism": "",
    "introduction": "Light puzzle gameplay",
    "description": "A classic match-3 casual game",
    "service_phone": "400-123-4567",
    "service_email": "support@example.com",
    "service_privacy": "https://example.com/privacy"
  },
  "timestamp": 1719820800000
}

Error Response ​

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