tt.setUserStorage
2020-02-12 16:50 更新
以 key-value 形式上报用户数据到字节跳动的云存储服务。
接口地址
POST https://developer.toutiao.com/api/apps/set_user_storage
输入
名称 | 描述 |
---|---|
access_token | 服务端 API 调用标识,获取方法 |
openid | 登录用户唯一标识 |
signature | 用户登录态签名,参考用户登录态签名算法 |
sig_method | 用户登录态签名的编码方法,参考用户登录态签名算法 |
kv_list | (body 中) 要设置的用户数据 |
输出
返回值为 JSON 形式。
当服务器端正确返回时,会返回如下信息:
名称 | 数据类型 | 取值 |
---|---|---|
errcode | number | 0 |
当服务器端无法正确返回时,会返回如下信息:
名称 | 数据类型 | 描述 |
---|---|---|
errcode | number | 错误号 |
errmsg | string | 错误信息 |
具体对应关系为:
错误号 | 描述 |
---|---|
0 | 请求成功 |
-1 | 系统错误 |
40009 | key 长度大于 128 个字节 |
40010 | key 和 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}}"
以上内容是否对您有帮助:
更多建议: