Skip to content

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 ​

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.software_copyrightobjectSoftware copyright
data.software_copyright.certificate_picturestringCertificate image URL
data.software_copyright.certificate_numberstringRegistration number
data.software_copyright.authorization_contractsarrayAuthorization contract URL list
data.publication_numberobjectPublication number / ISBN
data.publication_number.isbn_picturestringISBN image URL
data.publication_number.isbnstringISBN / publication number
data.publication_number.registrationstringAuthority registration number
data.publication_number.authorization_contractsarrayAuthorization contract URL list
data.supplementary_materialsarraySupplementary material URL list
data.self_inspectionbooleanSelf-inspection flag (may be null)
timestamplongMillisecond timestamp

Valid values of ret_code ​

ValueDescriptionMin version
0Success
40001invalid access_token
40003game 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"
}