removeUserStorage

本接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說明參見服務(wù)端API。
刪除已經(jīng)上報(bào)到QQ的key-value數(shù)據(jù)

請(qǐng)求地址

POST https://api.q.qq.com/api/openDataContext/remove_user_storage?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD

請(qǐng)求參數(shù)

返回值

Object

返回的 JSON 數(shù)據(jù)包

errcode 的合法值

示例代碼

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

本接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說明參見服務(wù)端API。 上報(bào)用戶數(shù)據(jù)后臺(tái)接口。小游戲可以通過本接口上報(bào)key-value數(shù)據(jù)到用戶的CloudStorage。

請(qǐng)求地址

POST https://api.q.qq.com/api/openDataContext/set_user_storage?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD

請(qǐng)求參數(shù)

kv_list 的結(jié)構(gòu)

返回值

Object

返回的 JSON 數(shù)據(jù)包

errcode 的合法值

示例代碼

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'

托管數(shù)據(jù)的限制

如果在上報(bào)數(shù)據(jù)時(shí)觸發(fā)這些限制，設(shè)置數(shù)據(jù)會(huì)失敗并且會(huì)收到帶錯(cuò)誤碼的返回包。 每個(gè)openid所標(biāo)識(shí)的QQ用戶，在游戲當(dāng)中的托管的數(shù)據(jù)不能超過128個(gè)key-value對(duì)。

上報(bào)的key-value列表當(dāng)中每一項(xiàng)的key+value長(zhǎng)度都不能超過1K(1024)字節(jié)。

上報(bào)的key-value列表當(dāng)中每一個(gè)key長(zhǎng)度都不能超過128字節(jié)。

setUserInteractiveData

本接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說明參見服務(wù)端API。 寫用戶關(guān)系鏈互動(dòng)數(shù)據(jù)存儲(chǔ)。

請(qǐng)求地址

POST https://api.q.qq.com/api/setuserinteractivedata?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD

請(qǐng)求參數(shù)

屬性 類型 默認(rèn)值 必填 說明 access_token string

是 接口調(diào)用憑證 openid string

是 用戶唯一標(biāo)識(shí)符 signature string

是 用戶登錄態(tài)簽名，簽名算法請(qǐng)參考用戶登錄態(tài)簽名算法 sig_method string

是 用戶登錄態(tài)簽名的哈希方法，如hmac_sha256等，請(qǐng)參考用戶登錄態(tài)簽名算法 kv_list Object

是 要上報(bào)的數(shù)據(jù) kv_list 的結(jié)構(gòu) 屬性 類型 默認(rèn)值 必填 說明 key string

是 需要修改的數(shù)據(jù)的 key，目前可以為 '1' - '50' value Number

是 數(shù)據(jù)的value，目前只能為 1

返回值

Object

返回的 JSON 數(shù)據(jù)包 屬性 類型 說明 errcode number 錯(cuò)誤碼 errmsg number 錯(cuò)誤信息 errcode 的合法值 值 說明 0 請(qǐng)求成功 -1 系統(tǒng)繁忙，此時(shí)請(qǐng)開發(fā)者稍候再試 -2 kv_list不存在 -3 鑒權(quán)參數(shù)類型錯(cuò)誤 -4 鑒權(quán)參數(shù)缺失 -100050007 簽名校驗(yàn)失敗 -100050019 accesstoken錯(cuò)誤

示例代碼

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'

簽名的內(nèi)容為{"kv_list":[{"key":"1","value":0}]} 簽名的秘鑰為用戶的SessionKey