# 用户卡面信息项主动更新
# 1.接口地址
# 请求方法:
POST(application/json)
# 请求地址:
https://weixiao.qq.com/apps/v1/data/update-sync-fields
# 2.请求参数
原始数据 R
:
{
"app_key":"APP_KEY",
"nonce_str":"NONCE_STR",
"timestamp":"TIMESTAMP",
"card_field": "CARD_FIELD",
"card_info": [
{
"card_number": "CARD_NUMBER",
"value": "VALUE"
},
{
"card_number": "CARD_NUMBER",
"value": "VALUE"
},
],
"sign":"SIGN"
}
参数说明:
变量名 | 必填 | 示例值 | 类型 | 说明 |
---|---|---|---|---|
app_key | 是 | SDFSDFD | String | uni分配的应用APP_KEY |
timestamp | 是 | 1514276659 | int | 当前unix时间戳 |
nonce_str | 是 | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | String(32) | 32位随机字符串 |
card_field | 是 | balance | String(32) | 需要更新的信息项: 余额balance,图书借阅borrow,补贴subsidy,餐次mealtimes |
card_info | 是 | array | 对应卡片字段的更新信息项 | |
card_number | 是 | 3128606123 | String | 学生卡的卡号 |
value | 是 | 2 | int | 要更新字段的值 |
sign | 是 | a790e009d30c09bd8605810eaf9c44b0 | String(32) | 按照签名算法生成的签名(参考签名算法) |
通过加密R
可以得到R'
:R' = AES_CBC_ENCRYPT(R)
。
{
"raw_data":R',
"app_key":APP_KEY
}
将加密后的数据发送到更新接口
# 3.数据返回
# 响应说明:
{
"errcode":0,
"errmsg":"success",
}
# 错误返回:
{
"errcode":CODE, (错误码)
"errmsg":"MESSAGE", (错误信息)
}
# 4.错误状态码:
- 5004 - 签名验证不通过
- 9007 - 不合法的app_key
- 9015 - 解密错误
- 9016 - 信息项同步字段名错误
- 9017 - 不合法的app_key
- 9018 - 接口调用过于频繁(一分钟最多调用60次)