# 券码历史记录查询

**接口用途**

- 券码历史记录查询 （根据上送券码，查询当前券码历史相关记录信息）
- [签名](https://book.e-buy.com/books/c20ad/page/5878a)

**action**

- /api/whaleStarbucksCode/getCodeRecords

**请求参数，中间件===>易百后台**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>requestId</td><td>String</td><td>是</td><td>流水号</td><td>不允许重复，用于单次请求日志追踪查询</td></tr><tr><td>code</td><td>String</td><td>是</td><td>券码</td><td>券号code</td></tr><tr><td>sign</td><td>String</td><td>是</td><td>签名串</td><td>券码查询签名串和顺序

signStr = "requestId=1754036646424&amp;code=1006250730320020870=gHN3981K"

</td></tr></tbody></table>

**请求报文举例**

```
{
    "code": "1006250730320020870=gHN3981K",
    "requestId": 1754036646424,
    "sign": "k8l22s6PQHhwskkUx4BKD+dqCtCuYVuE5pC9ikbaIUG/K68xqvytLajPumygrF9VqP13vJHe0lWOUm0+9Fqzt17jU+36naYLoXh8o70BH4HIrA3xswmiHkgcoZ+OxQfOxLqLO/QghHKMPJFYu7El72a/HY12Q7QntGiMV2SADTq4VQIMfDjVZ4YmovN231TLD78cyJsdPUXmIRMbB+rqaR6cglTiPoyPOtdcgou1XFth2aC1zJH5WiCe/qwpiFSzLquQSo02theZ1C/A6OVqBKwNBOBxMQ0vnAZYUZ8QMG5ivxj4grGOoCSWcjHI4rRn3SKJNZJonNQgm68VAWPSIA=="
}
```

**返回参数，易百后台===&gt;中件间**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t-1"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td><div><div>returnCode</div></div></td><td>String</td><td>是</td><td>返回响应码</td><td>  
</td></tr><tr><td><div><div>transTime</div></div></td><td>String</td><td>是</td><td>交易时间</td><td>  
</td></tr><tr><td><div><div>requestId</div></div></td><td>String</td><td>是</td><td>返回请求流水</td><td>  
</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>  
</td></tr><tr><td><div><div>returnData</div></div></td><td>List&lt;[voucherPkg](https://book.e-buy.com/books/c20ad/page/58238)&gt;</td><td>否</td><td>交易记录信息</td><td>  
</td></tr></tbody></table>

**返回报文举例（请求中 businessType 值为 12 时）**

```
{
    "returnCode": "00",
    "transTime": 1754016597099,
    "requestId": "1754016596841",
    "returnData": [
        {
            "dateTime": "20250730143743",
            "returnCode": "00",
            "returnMsg": "操作成功",
            "code": "1006250730320020870=gHN3981K",
            "mid": "",
            "shopName": "",
            "type": "1",
            "shopNo": "",
            "tid": "",
            "swift": ""
        },
        {
            "dateTime": "20250730153314",
            "returnCode": "00",
            "returnMsg": "SUCCESS",
            "code": "1006250730320020870=gHN3981K",
            "mid": "860020051401034",
            "shopName": "星巴克北京银泰店",
            "type": "2",
            "shopNo": "1490",
            "tid": "54022101",
            "swift": "0"
        },
        {
            "dateTime": "20250730211518",
            "returnCode": "00",
            "returnMsg": "SUCCESS",
            "code": "1006250730320020870=gHN3981K",
            "mid": "860020051401034",
            "shopName": "星巴克北京银泰店",
            "type": "2",
            "shopNo": "1490",
            "tid": "54022101",
            "swift": "0",
            "extendData": {
                "shopNo": "test1",
                "voucherNo": "test1",
                "posSerialNo": "test1",
                "oms": "test1"
            }
        }
    ],
    "returnDesc": "success"
}
```