removeUserStorage
本接口应在服务器端调用，详细说明参见服务端API。
删除已经上报到QQ的key-value数据
请求地址
POST https://api.q.qq.com/api/openDataContext/remove_user_storage?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD请求参数
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 | |
| openid | string | 是 | 用户唯一标识符 | |
| signature | string | 是 | 用户登录态签名，签名算法请参考用户登录态签名算法 | |
| sig_method | string | 是 | 用户登录态签名的哈希方法，如hmac_sha256等，请参考用户登录态签名算法 | |
| key | string | 是 | 要删除的数据key列表 |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | number | 错误信息 |
errcode 的合法值
| 值 | 说明 |
|---|---|
| 0 | 请求成功 |
| -1 | 系统繁忙，此时请开发者稍候再试 |
示例代码
curl -d '{ "key":["gold", "score"] }' \
'https://api.q.qq.com/api/openDataContext/remove_user_storage?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD'setUserStorage
本接口应在服务器端调用，详细说明参见服务端API。 上报用户数据后台接口。小游戏可以通过本接口上报key-value数据到用户的CloudStorage。
请求地址
POST https://api.q.qq.com/api/openDataContext/set_user_storage?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD请求参数
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 | |
| openid | string | 是 | 用户唯一标识符 | |
| signature | string | 是 | 用户登录态签名，签名算法请参考用户登录态签名算法 | |
| sig_method | string | 是 | 用户登录态签名的哈希方法，如hmac_sha256等，请参考用户登录态签名算法 | |
| kv_list | Object | 是 | 要上报的数据 |
kv_list 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| key | string | 是 | 数据的key | |
| value | string | 是 | 数据的value |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | number | 错误信息 |
errcode 的合法值
| 值 | 说明 |
|---|---|
| 0 | 请求成功 |
| -1 | 系统繁忙，此时请开发者稍候再试 |
| 87016 | 由于某个key-value长度超过限制而上报失败。 |
| 87017 | 由于用户存储的数据量超过限制而上报失败。 |
| 87018 | 由于用户存储的key-value对数量超过限制而上报失败。 |
| 87019 | 由于某个key长度超过限制而上报失败。 |
示例代码
curl -d '{ "kv_list":[{"key":"score","value":"100"},{"key":"gold","value":"3000"}] }' 'https://api.q.qq.com/api/openDataContext/set_user_storage?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD'托管数据的限制
如果在上报数据时触发这些限制，设置数据会失败并且会收到带错误码的返回包。 每个openid所标识的QQ用户，在游戏当中的托管的数据不能超过128个key-value对。
上报的key-value列表当中每一项的key+value长度都不能超过1K(1024)字节。
上报的key-value列表当中每一个key长度都不能超过128字节。
setUserInteractiveData
本接口应在服务器端调用，详细说明参见服务端API。 写用户关系链互动数据存储。
请求地址
POST https://api.q.qq.com/api/setuserinteractivedata?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD请求参数
属性 类型 默认值 必填 说明 access_token string
是 接口调用凭证 openid string
是 用户唯一标识符 signature string
是 用户登录态签名，签名算法请参考用户登录态签名算法 sig_method string
是 用户登录态签名的哈希方法，如hmac_sha256等，请参考用户登录态签名算法 kv_list Object
是 要上报的数据 kv_list 的结构 属性 类型 默认值 必填 说明 key string
是 需要修改的数据的 key，目前可以为 '1' - '50' value Number
是 数据的value，目前只能为 1
返回值
Object
返回的 JSON 数据包 属性 类型 说明 errcode number 错误码 errmsg number 错误信息 errcode 的合法值 值 说明 0 请求成功 -1 系统繁忙，此时请开发者稍候再试 -2 kv_list不存在 -3 鉴权参数类型错误 -4 鉴权参数缺失 -100050007 签名校验失败 -100050019 accesstoken错误
示例代码
curl -d '{ "kv_list":[{"key":"score","value":"100"},{"key":"gold","value":"3000"}] }' 'https://api.q.qq.com/api/setuserinteractivedata?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD'
签名的内容为{"kv_list":[{"key":"1","value":0}]} 签名的秘钥为用户的SessionKey