# setUserStorage ### setUserStorage 上報用戶數據后臺接口。小游戲可以通過本接口上報key-value數據到用戶的CloudStorage。 #### 請求地址 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln">POST https</span><span class="pun">:</span><span class="com">//api.weixin.qq.com/wxa/set_user_storage?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD</span></code></li></ol> ``` #### 參數 ##### string access\_token [接口調用憑證](/read/wechat-game-api/297.md) ##### string openid 用戶唯一標識符 ##### string signature 用戶登錄態簽名，簽名算法請參考[用戶登錄態簽名算法](https://developers.weixin.qq.com/minigame/dev/tutorial/open-ability/session-signature.html) ##### string sig\_method 用戶登錄態簽名的哈希方法，如hmac\_sha256等，請參考[用戶登錄態簽名算法](https://developers.weixin.qq.com/minigame/dev/tutorial/open-ability/session-signature.html) ##### Object kv\_list 要上報的數據 屬性類型默認值是否必填說明支持版本keystring是數據的keyvaluestring是數據的value#### 返回值 ##### Object 返回的 JSON 數據包 屬性類型說明支持版本errcodenumber錯誤碼errmsgnumber錯誤信息**errcode 的合法值** 值說明0請求成功-1系統繁忙，此時請開發者稍候再試87016由于某個key-value長度超過限制而上報失敗。87017由于用戶存儲的數據量超過限制而上報失敗。87018由于用戶存儲的key-value對數量超過限制而上報失敗。87019由于某個key長度超過限制而上報失敗。#### 示例代碼 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln">curl </span><span class="pun">-</span><span class="pln"> d </span><span class="str">'{ "kv_list":[{"key":"score","value":"100"},{"key":"gold","value":"3000"}] }'</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="str">'https://api.weixin.qq.com/wxa/set_user_storage?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD'</span></code></li> </ol> ``` #### 托管數據的限制 如果在上報數據時觸發這些限制，設置數據會失敗并且會收到帶錯誤碼的返回包。 - 每個openid所標識的微信用戶，在游戲當中的托管的數據不能超過128個key-value對。 - 上報的key-value列表當中每一項的key+value長度都不能超過1K(1024)字節。 - 上報的key-value列表當中每一個key長度都不能超過128字節。 > 原文: <https://developers.weixin.qq.com/minigame/dev/api/open-api/data/setUserStorage.html>