# 接口说明



# 调用方法

<table id="bkmrk-%E5%86%85%E5%AE%B9-%E8%AF%B4%E6%98%8E-%E9%80%9A%E8%AE%AF%E6%96%B9%E5%BC%8F-tcp%2Fip%C2%A0so" style="width: 644px;"><thead><tr><th style="width: 150px;">内容</th><th style="width: 494px;">说明</th></tr></thead><tbody><tr><td style="width: 150px;">通讯方式</td><td style="width: 494px;">TCP/IP [Socket](https://book.e-buy.com/link/391#bkmrk-socket "基于TCP/IP协议的通讯方式"),监听127.0.0.1端口</td></tr><tr><td style="width: 150px;">端口</td><td style="width: 494px;">监听单个端口，支持收发，使用3018端口</td></tr><tr><td style="width: 150px;">交互数据格式</td><td style="width: 494px;">JSON</td></tr><tr><td style="width: 150px;">字符编码</td><td style="width: 494px;">UTF-8</td></tr><tr><td style="width: 150px;">签名验证</td><td style="width: 494px;">本机通讯无需签名</td></tr></tbody></table>

# 报文结构

**请求报文和返回报文都采用如下的报文结构**

<table id="bkmrk-%E6%8A%A5%E6%96%87%E9%95%BF%E5%BA%A6-%E6%8A%A5%E6%96%87%E5%86%85%E5%AE%B9-2%E4%B8%AA%E5%AD%97%E8%8A%82-hex%E6%A0%BC%E5%BC%8F" style="width: 281px;"><thead><tr><th style="width: 141px;">报文长度</th><th style="width: 140px;">报文内容</th></tr></thead><tbody><tr><td style="width: 141px;">2个字节 HEX格式</td><td style="width: 140px;">明文ASCII格式</td></tr></tbody></table>

**其中报文内容采用如下JSON结构**

<table id="bkmrk-%E5%BA%8F%E5%8F%B7-%E6%A0%BC%E5%BC%8F-%E5%8F%82%E6%95%B0-%E6%95%B0%E6%8D%AE%E4%B8%BE%E4%BE%8B-%E5%8F%82%E6%95%B0%E8%AF%B4%E6%98%8E-%E5%A4%87"><thead><tr><th>序号</th><th>格式</th><th>参数</th><th>数据举例</th><th>参数说明</th><th>备注</th></tr></thead><tbody><tr><td>1</td><td>action</td><td>String</td><td>inquiry</td><td>交易类型</td><td>具体接口有详细说明</td></tr><tr><td>2</td><td>deviceNo</td><td>String</td><td>POS01</td><td>收银机编号</td><td>用于区别本次交易请求的收银机</td></tr><tr><td>3</td><td>shopNo</td><td>String</td><td>CN123456</td><td>门店编号</td><td>用于区别本次交易请求的门店</td></tr><tr><td>4</td><td>brand</td><td>String</td><td>663</td><td>品牌编号</td><td>用于区别本次交易请求的品牌，易百分配</td></tr><tr><td>5</td><td>body</td><td>String</td><td>BASE64</td><td>报文内容</td><td>具体接口有详细说明，本域需要采用BASE64编码</td></tr></tbody></table>

**报文举例**

```
0x00 0xE7{"action":"inquiry","deviceNo":"POS01","shopNo":"CN123456","brand":"663","body":"ewogICAgICAgICAidHJhY2VObyI6ICI5OTAwMDAwOTEwMDAxMDEwMTczMjEyMyIsCiAgICAgICAgICJvcmlnaW5hbFRyYWNlTm8iOiAiOTkwMDAwMDkxMDAwMTAxMDE3MzIxMjQiCiAgICAgfQ=="}

```

- 其中00E7表示报文内容长度为231个字节