setUserStorage

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

请求地址

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

请求参数

属性数据类型是否必填说明
access_tokenstring服务端 API 调用标识,获取方法
openidstring登录用户唯一标识 获取方法
signaturestring用户登录态签名,参考用户登录态签名算法
sig_methodstring用户登录态签名的编码方法,参考用户登录态签名算法
kv_listArray< KvItem>(body 中) 要设置的用户数据

KvItem 结构体

属性数据类型说明
keystring
valuestring

返回值

返回值为 JSON 形式。

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

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

errCode

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

属性数据类型说明
errorint64返回非 0
errcodeint64详细错误号
errmsgstring错误信息
messagestring错误信息(同 errmsg)

具体对应关系为:

错误号说明
0请求成功
-1系统错误
40009key 长度大于 128 个字节
40010key 和 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所指出的形式。
点击纠错
评价此篇文档