## 接口調用請求說明
#### 請求Url：
http://zk.mschong.com/addons/execute/api-api-addUserScore.html
#### 請求類型：
POST
### 請求參數
| 字段名 | 變量名 | 必填 | 示例值 | 類型 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 商戶賬號appid | appid | 是 | czxj5869 | String(128) | 申請商戶號的appid |
| 隨機字符串 | nonce\_str | 是 | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | String(32) | 隨機字符串，不長于32位 |
| 簽名 | sign | 是 | C380BEC2BFD727A4B6845133519F3AD6 | String(32) | 簽名，詳見[簽名算法] |
| 用戶綁定的手機號碼 | phone | 是 | 15759116288 | String(11) | 戶綁定的手機號碼 |
| 請求時間戳 | time | 是 | 1574409580 | int(12) | 時間戳（格林威治時間） |
| 充值的積分額度 | score | 是 | 88 | int(10) | 充值的積分額度 |
**簽名算法**
第一步，設所有發送或者接收到的數據為集合M，將集合M內非空參數值的參數按照參數名ASCII碼從小到大排序（字典序），使用URL鍵值對的格式（即`key1=value1&key2=value2…`）拼接成字符串`stringA`。
第二步，在`stringA`最后拼接上`key`得到`stringSignTemp`字符串，并對`stringSignTemp`進行MD5運算，再將得到的字符串所有字符轉換為大寫，得到sign值`signValue`。
**舉例：**
假設傳送的參數如下：
```
appid： czxj5869
nonce_str： oebnwVHQwo
phone：18065921051
time：157441127
score：88
```
第一步：對參數按照key=value的格式，并按照參數名ASCII字典序排序如下：
```
stringA="appid=czxj5869&nonce_str=oebnwVHQwo&phone=18065921051&score=10&time=157441127";
```
第二步：拼接API密鑰：
```
stringSignTemp=stringA+"&key=192006250b4c09247ec02edce69f6a2d"//注：key為商戶平臺設置的密鑰key
sign=MD5(stringSignTemp).toUpperCase()="14CADF2DAB1871B2D23AD901453C12CC"//注：MD5簽名方式
sign=hash_hmac("sha256",stringSignTemp,key).toUpperCase()="6A9AE1657590FD6257D693A078E1C3E4BB6BA4DC30B23E0EE2496E54170DACD6"//注：HMAC-SHA256簽名方式
```
### 返回參數
| 字段名 | 變量名 | 必填 | 示例值 | 類型 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 返回狀態碼 | code | 是 | 1 | int(10) | 狀態碼，只有狀態碼為1的時候成功，其它均為失敗，請根據提示進行修改 |
| 返回信息 | msg | 是 | 簽名失敗 | String(128) | 返回信息，如非空，為錯誤原因 |
| 返回數據 | data | 是 | 數據 | String(1000) | 成功時返回操作相關的數據 |
