# 用户卡面信息项主动更新

# 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次)