setUserStorage
收藏接口说明
以 key-value 形式存储用户数据到小程序平台的云存储服务。若开发者无内部存储服务则可接入，免费且无需申请。一般情况下只存储用户的基本信息，禁止写入大量不相干信息。
Bug&Tip
- Tip：当 key 是开发者所配置的排行榜 key 时，value 的内容应该满足KVData所指出的形式，必须是 string 类型，不要传 json struct。
- Tip: 该方法为服务端方法，实际方法效果与前端接口 tt.setUserCloudStorage 一致。通过该接口设置数据后，可以在前端通过 tt.getUserCloudStorage 或 tt.getCloudStorageByRelation 获取。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://minigame.zijieapi.com/mgplatform/api/apps/set_user_storage |
| HTTP Method | POST |
| Scope | open.ttgame.mgplatform |
| 权限要求 | 以 key-value 形式存储用户数据到小程序平台的云存储服务。若开发者无内部存储服务则可接入，免费且无需申请。一般情况下只存储用户的基本信息，禁止写入大量不相干信息。 |
请求参数
请求头
content-type必填String
固定值"application/json"
Query
access_token必填String
示例：08011218462b6b4b5054626e426e50685a7554643144644449413d3d
openid必填String
登录用户唯一标识
sig_method必填String
用户登录态签名的编码方法
signature必填String
用户登录态签名
Body展开全部子属性
kv_list必填List
(body 中) 要设置的用户数据
展开子属性
请求示例
curl --location --request POST '/mgplatform/api/apps/set_user_storage?openid=oPLfFqp5Ve&signature=NkmoxSAFXB&sig_method=78w5lVsOmy' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"kv_list":[{"value":"9XvPlS2jlm","key":"BaJRrZDt1w"}]}' # 此示例仅为模板，请修改为更加符合业务规则的调用示例，方便开发者查看
响应参数
Body
error必填Int32
错误号, 正确返回时为 0
errcodeInt32
详细错误号
errmsgString
错误信息
messageString
错误信息（同 errmsg）
响应示例
{ "error": 7615134304097238000, "message": "zYUFO6GCJz", "errcode": 980888087500398600, "errmsg": "IphPznh1CX" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | 请求成功 | |
| 200 | -1 | 系统错误 | |
| 200 | 40009 | key 长度大于 128 个字节 | |
| 200 | 40010 | key 和 value 的长度 和大于 1024 个字节 | |
| 200 | 40011 | 排行榜 key 对应的 value 值格式不对，具体见 warning | |
| 200 | 60001 | 单用户存储 kv 超过 128 对 |
