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
| Property | Type | Default | Required | Description |
|---|---|---|---|---|
| Authorization | string | Yes | Format: Bearer {access_token} |
Request Parameters - Body
| Property | Type | Default | Required | Description |
|---|---|---|---|---|
| bundle_id | string | Yes | Package name from game.queryList |
Return Value
Object
Returned JSON packet
| Property | Type | Description |
|---|---|---|
| ret_code | integer | 0 success, non-zero failure |
| ret_msg | string | "success" or error reason |
| data | object | Business body (when ret_code=0) |
| data.bundle_id | string | Package name |
| data.name | string | Game name |
| data.icon | string | Game icon (first item of icon set; empty if none) |
| data.version | string | Latest version |
| data.engine | string | Game engine |
| data.first_category | string | Primary category |
| data.second_category | string | Secondary category |
| data.min_age | string | Age rating |
| data.special_mechanism | string | Special mechanism |
| data.introduction | string | Short introduction |
| data.description | string | Detailed description |
| data.service_phone | string | Support phone |
| data.service_email | string | Support email |
| data.service_privacy | string | Privacy policy URL |
| timestamp | long | Millisecond timestamp |
Valid values of ret_code
| Value | Description | Min version |
|---|---|---|
| 0 | Success | |
| 40001 | invalid access_token | |
| 40003 | game 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"
}