setUserStorage

以 key-value 形式存储用户数据到小程序平台的云存储服务。若开发者无内部存储服务则可接入，免费且无需申请。一般情况下只存储用户的基本信息，禁止写入大量不相干信息。

请求地址

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

KvItem 结构体

属性	数据类型	说明
key	string	键
value	string	值

正确返回的 JSON 如下：

属性	数据类型	说明
error	int64	错误号, 正确返回时为 0

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

具体对应关系为：

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

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

其余参数传入 url

正确返回

{
  "error": 0
}

错误返回

{
  "errcode": 40002,
  "errmsg": "nil access_token",
  "error": 1,
  "message": "nil access_token"
}

Tip：当 key 是开发者所配置的排行榜 key 时，value 的内容应该满足KVData所指出的形式，必须是 string 类型，不要传 json struct。
Tip: 该方法为服务端方法，实际方法效果与前端接口 tt.setUserCloudStorage 一致。通过该接口设置数据后，可以在前端通过 tt.getUserCloudStorage 或 tt.getCloudStorageByRelation 获取。

点击纠错

该文档是否对你的开发有所帮助？

有帮助

没帮助

该文档是否对你的开发有所帮助？

有帮助

没帮助