查询游戏数据

GET /v1/query-game-data

查询指定合作方用户在指定游戏中的游戏数据，如对局记录、对局统计等。

信息

调用此接口前，用户必须已完成角色绑定。如未绑定，接口将返回 binding_not_found 错误。参见 绑定流程。

Request

通过 Query String 传递参数：

Property	Type	Required	Description
query_type	string	True	要查询的数据类型。不同游戏支持的取值不同，请联系金山世游外部平台对接人员获取。
game_id	string	True	游戏 ID。
partner_user_id	string	True	合作方平台的用户唯一标识。

示例：

GET /v1/query-game-data?query_type=matches&game_id=ggd&partner_user_id=user_12345

Response

Response Body 的结构取决于 game_id 和 query_type 的取值。请联系金山世游外部平台对接人员获取详细文档。

Errors

Error	Description
invalid_request	请求参数缺失或格式错误。
invalid_signature	签名验证不通过。
partner_disabled	合作方已被禁用。
invalid_query_type	不支持的数据查询类型。请检查 query_type 参数是否为指定游戏支持的取值。
binding_not_found	该用户在该游戏中未绑定角色，或绑定关系已解除。
role_not_found	绑定的角色不存在（例如角色已被删除）。
internal_error	服务端内部错误。可能由游戏服务器超时或无响应导致。