Webhook

Webhook 是用户定义的基于 HTTP 的事件回调。Webhook 通常被事件激活。这个是由 Jeff Lindsay 在 2007 年基于 Hook 的概念提出。业界相对著名的实现，有

• Github Webhook (opens new window),
• 微信公众号消息 (opens new window)

等等。

回调配置

在集成新核云与三方系统时，我们推荐三方系统搭建一个回调服务。回调服务可以实现：

1. 自定义丰富的服务行为。比如，用户新增备料出库申请，可以在对应的 WMS 中生成出库申请单；
2. 可以及时获取到状态变化。比如，生产单派发，可以级联更新自有系统。

配置回调服务

回调接口配置功能

1. Http Get 请求验证 URL 有效性
2. Http Post 请求接收业务数据

假设企业的接收消息的 URL 设置为 http://api.guanhong.com/xhy/open。
当用户触发新建采购清单时，企业微信会发送回调消息到填写的 URL，请求内容如下：

请求方式：POST
请求地址：http://api.guanhong.com/xhy/open
请求数据格式：

{
  "requestId": "123e4567e89b12d3a456426614174000",
  "businessType": "CREATE_PURCHASE_REQUISITION",
  "data": {
    "code": "",
    "createTime": 0,
    "records": [
      {
        "confirmedQuantity": 0,
        "itemCode": "",
        "quantity": 0
      }
    ],
    "staffCode": ""
  }
}

其他推送接口请参考具体的 Webhook 定义