game.queryKYC
This interface is implemented by the platform application (APP) server and called by the SUD OpenPaaS server.
Query game qualifications (software copyright, publication number, etc.) by package name. Aligned with ThirdPartyPlatformGameQualification; reference: helloOP GET /developer/game/qualification. When no qualification data exists, still return the nested structure with empty fields/arrays.
Invocation method:
- HTTPS call
HTTPS Call
http
POST {query_game_kyc_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.software_copyright | object | Software copyright |
| data.software_copyright.certificate_picture | string | Certificate image URL |
| data.software_copyright.certificate_number | string | Registration number |
| data.software_copyright.authorization_contracts | array | Authorization contract URL list |
| data.publication_number | object | Publication number / ISBN |
| data.publication_number.isbn_picture | string | ISBN image URL |
| data.publication_number.isbn | string | ISBN / publication number |
| data.publication_number.registration | string | Authority registration number |
| data.publication_number.authorization_contracts | array | Authorization contract URL list |
| data.supplementary_materials | array | Supplementary material URL list |
| data.self_inspection | boolean | Self-inspection flag (may be null) |
| 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_kyc_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": {
"software_copyright": {
"certificate_picture": "https://cdn.example.com/sc.png",
"certificate_number": "2024SR1234567",
"authorization_contracts": ["https://cdn.example.com/auth1.pdf"]
},
"publication_number": {
"isbn_picture": "https://cdn.example.com/isbn.png",
"isbn": "ISBN-XXXX",
"registration": "Authority registration number",
"authorization_contracts": []
},
"supplementary_materials": [],
"self_inspection": null
},
"timestamp": 1719820800000
}Error Response
json
{
"ret_code": 40001,
"ret_msg": "invalid access_token"
}