setUserStorage

以 key-value 形式上报用户数据到字节跳动的云存储服务。

接口地址

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

输入

名称描述
access_token服务端 API 调用标识,获取方法
openid登录用户唯一标识
signature用户登录态签名,参考用户登录态签名算法
sig_method用户登录态签名的编码方法,参考用户登录态签名算法
kv_list(body 中) 要设置的用户数据

输出

返回值为 JSON 形式。

当服务器端正确返回时,会返回如下信息:

名称数据类型取值
errcodenumber0

当服务器端无法正确返回时,会返回如下信息:

名称数据类型描述
errcodenumber错误号
errmsgstring错误信息

具体对应关系为:

错误号描述
0请求成功
-1系统错误
40009key 长度大于 128 个字节
40010key 和 value 的长度和大于 1024 个字节
40011排行榜 key 对应的 value 值格式不对,具体见 warning
60001单用户存储 kv 超过 128 对
其它参数错误

示例

body 示例如下:

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

⚠️ 注意

当 key 是开发者所配置的排行榜 key 时,value 的内容应该满足KVData所指出的形式, 即形如 "{\"ttgame\":{\"score\":1}}"

点击纠错