16.3.1 查询Code

调用核销Code接口之前需要调用查询Code接口，并在核销之前对非法状态的Code（如转赠中、已删除、已核销等）进行处理。

查询Code的接口如下。

---

https:// api.weixin.qq.com/card/code/get?access_token=TOKEN
  

---

查询Code时，POST数据示例如下。

---

{
    "card_id":"card_id_123+",
    "code":"123456789",
    "check_consume":true
}
  

---

上述数据的参数说明如表16-13所示。

表16-13　查询Code接口的参数说明

正确创建时，返回的数据示例如下。

---

{
    "errcode":0,
    "errmsg":"ok",
    "card":{
        "card_id":"pbLatjk4T4Hx-QFQGL4zGQy27_Qg",
        "begin_time":1457452800,
        "end_time":1463155199
    },
    "openid":"obLatjm43RA5C6QfMO5szKYnT3dM",
    "can_consume":true,
    "user_card_status":"NORMAL"
}
  

---

上述数据的参数说明如表16-14所示。

表16-14　查询Code接口返回参数说明