tt.setUserStorage

2020-02-12 16:50 更新

以 key-value 形式上報(bào)用戶數(shù)據(jù)到字節(jié)跳動的云存儲服務(wù)。

接口地址

POST https://developer.toutiao.com/api/apps/set_user_storage

名稱	描述
`access_token`	服務(wù)端 API 調(diào)用標(biāo)識，獲取方法
`openid`	登錄用戶唯一標(biāo)識
`signature`	用戶登錄態(tài)簽名，參考用戶登錄態(tài)簽名算法
`sig_method`	用戶登錄態(tài)簽名的編碼方法，參考用戶登錄態(tài)簽名算法
`kv_list`	(body 中) 要設(shè)置的用戶數(shù)據(jù)

返回值為 JSON 形式。

當(dāng)服務(wù)器端正確返回時(shí)，會返回如下信息：

名稱	數(shù)據(jù)類型	取值
errcode	`number`	0

當(dāng)服務(wù)器端無法正確返回時(shí)，會返回如下信息：

名稱	數(shù)據(jù)類型	描述
errcode	`number`	錯誤號
errmsg	`string`	錯誤信息

具體對應(yīng)關(guān)系為：

錯誤號	描述
`0`	請求成功
`-1`	系統(tǒng)錯誤
`40009`	key 長度大于 128 個字節(jié)
`40010`	key 和 value 的長度和大于 1024 個字節(jié)
`40011`	排行榜 key 對應(yīng)的 value 值格式不對，具體見 warning
`60001`	單用戶存儲 kv 超過 128 對
`其它`	參數(shù)錯誤

body 示例如下:

{"kv_list":[{"key":"test", "value":"{\"ttgame\":{\"score\":1}}"}]}

?? 注意當(dāng) key 是開發(fā)者所配置的排行榜 key 時(shí)，value 的內(nèi)容應(yīng)該滿足KVData所指出的形式，即形如 "{\"ttgame\":{\"score\":1}}"

以上內(nèi)容是否對您有幫助：

寫筆記

我要補(bǔ)充