事件订阅指南

新核云系统针对所有关键聚合的操作，提供可供应用订阅的事件。当事件发生时，新核云开放平台会安装相关应用配置的订阅方式发送事件消息。

1. 适用场景

事件订阅适用于实时数据处理、快速事件响应的场景。例如：

某应用看板需要实时更新生产报工进度，希望能及时获取新核云生产报工数据，则可以订阅报工记录创建事件。当产生生产报工记录时，该应用可以第一时间获取报工工序、操作人、报工数量等信息，进而更新生产报工进度。

某审核应用需要及时响应审核单提交审核的数据，则可以订阅生产单创建事件。当生产单创建提交审核时，则发送审核通知信息，以便于第一时间处理审核任务。

2. 订阅流程

2.1 确认事件订阅方式和订阅身份

目前新核云开放平台支持支持的订阅方式是将事件发送至开发者服务器，即使用传统的 Webhook 模式，该方式需要你提供用于接收事件消息的服务器公网地址。后续当应用订阅的事件发生时，开放平台会向服务器的公网地址发送 HTTP POST 请求，请求内包含事件数据。

为了提升开放平台的安全性，新核云开放平台设计了访问凭证（access_token）机制。订阅相关事件获取系统数据时，需要通过 access_token 对调用者身份进行鉴权。access_token 在下发的时候，会有一个过期时间（accessTokenExpireIn），过期后 access_token 即失效。在下发 access_token 的同时，新核云会提供 refresh_token，用于在 access_token 失效后，重新获得 access_token。注意 refresh_token也有过期时间（refreshTokenExpireIn），如果 refresh_token 也过期了，需要通过 APP Key 和 APP Secret 重新获取。

2.2 创建应用

在开放平台→ API & Webhook 注册第三方应用，获取APP Key 和APP Secret

2.3 配置事件订阅

为应用添加所需订阅的事件，并发布应用使配置生效。

2.4 接收事件

当新核云系统中相关事件发生时，新核云开放平台会将已订阅的事件推送至相应的开发者服务器。相关事件推送日志可以在应用详情的事件日志页签查看。

1. 适用场景#

2. 订阅流程#

2.1 确认事件订阅方式和订阅身份#

2.2 创建应用#