# 心跳

#### **接口用途**

- 中间件定时与易百后台进行通讯，上报当前状态并同步后台服务器状态，通过后台返回的指令调用相应的接口。

#### **接口地址**

- `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/heartbeat`

#### **action**

- `heartbeat`

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

<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 style="width: 117px;">字段</th><th style="width: 165px;">类型</th><th style="width: 77px;">是否必填</th><th style="width: 107px;">字段意义</th><th style="width: 343px;">备注</th></tr></thead><tbody><tr><td style="width: 117px;">traceNo</td><td style="width: 165px;">String</td><td style="width: 77px;">是</td><td style="width: 107px;">请求流水号</td><td style="width: 343px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 117px;">transTimestamp</td><td style="width: 165px;">List&lt;[transTimestamp](https://book.e-buy.com/books/e-buy-B6z/page/42998 "transTimestamp")&gt;</td><td style="width: 77px;">是</td><td style="width: 107px;">交易时间戳</td><td style="width: 343px;">用于统计每笔交易的耗时</td></tr><tr><td style="width: 117px;">businessType</td><td style="width: 165px;">int</td><td style="width: 77px;">否</td><td style="width: 107px;">心跳类型</td><td style="width: 343px;">0：外卖类； 1：其他类（供可扩展使用）</td></tr></tbody></table>

#### **请求报文举例**

```
  {
    "traceNo": "HB99000009100010101732123",
    "transTimestamp": [
      {
        "traceNo":"99000009100010101732123",
        "send":"1483372334",
        "recv":"1483372335"
      },
      {
        "traceNo":"99000009100010101732125",
        "send":"1483372336",
        "recv":"1483372337"
      }
    ],
    "businessType":0
  }

```

**返回参数，易百后台===&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-0"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>请求流水号</td><td>原样返回</td></tr><tr><td>transDate</td><td>String</td><td>是</td><td>交易时间</td><td>格式为：yyyyMMddHHmmss</td></tr><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00表示交易成功，其他表示失败</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr><tr><td>nextHeartbeat</td><td>Number</td><td>是</td><td>下次心跳间隔秒数</td></tr><tr><td>invokeAction</td><td>String</td><td>否</td><td>调用的接口action</td><td>如:signin 会在当日重新签到</td></tr><tr><td>alertMessage</td><td>String</td><td>否</td><td>提示信息</td><td>中间件弹出窗体提示这里返回的信息</td></tr><tr><td>businessOrderCount</td><td>int</td><td>否</td><td>未处理订单总数</td><td>用于外卖平台，获取最新未处理订单的总数</td></tr></tbody></table>

#### **返回报文举例**

```
{
    "traceNo": "99000009100010101732123",
    "transDate": "20161231102201",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "nextHeartbeat": 10,
    "invokeAction": "signin",
    "alertMessage": ""，
    "businessOrderCount":10
}
```