removeUserStorage

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

請求地址

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

請求參數(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)用，詳細說明參見服務(wù)端API。 上報用戶數(shù)據(jù)后臺接口。小游戲可以通過本接口上報key-value數(shù)據(jù)到用戶的CloudStorage。

請求地址

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

請求參數(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ù)的限制

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

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

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

setUserInteractiveData

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

請求地址

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

請求參數(shù)

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

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

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

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

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

是 要上報的數(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 錯誤碼 errmsg number 錯誤信息 errcode 的合法值 值 說明 0 請求成功 -1 系統(tǒng)繁忙，此時請開發(fā)者稍候再試 -2 kv_list不存在 -3 鑒權(quán)參數(shù)類型錯誤 -4 鑒權(quán)參數(shù)缺失 -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'

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