回收数据推送
功能
回收数据落库后推送给三方服务。
![](/img/docs/push_data.png)
使用步骤
一、推送服务
准备好需要接收数据的服务接口,目前支持的是 http(s)的形式。
🌀NOTE:可在 message 模块内扩展不同的通信类型:类型扩展。
二、创建回收数据推送任务
创建任务(批量绑定问卷)
一个任务对应一个推送地址。
POST /api/messagePushingTasks
此接口可批量绑定需要进行数据推送的问卷,也单独进行问卷绑定。
Request
名称 | 含义 | 类型 | 是否必填 | 默认值 |
---|---|---|---|---|
name | 任务名称 | String | Y | |
pushAddress | 推送地址 | String | Y | |
triggerHook | 触发时机 | MESSAGE_PUSHING_HOOK.RESPONSE_INSERTED | Y | |
surveys | 问卷 IDs | String[] | N | [] |
Response
名称 | 含义 | 类型 |
---|---|---|
taskId | 任务 ID | String |
示例
{
code: 200,
data: {
taskId: ...,
}
}
绑定单张问卷
POST /api/messagePushingTasks/:taskId/surveys/:surveyId
Request
名称 | 含义 | 类型 | 是否必填 | 默认值 |
---|---|---|---|---|
name | 任务名称 | String | Y | |
pushAddress | 推送地址 | String | Y | |
triggerHook | 触发时机 | String | Y | response_inserted |
surveys | 问卷 IDs | String[] | N | [] |
Response
名称 | 含义 | 类型 |
---|---|---|
data | 是否绑定成功 | Boolean |
示例
{
code: 200,
data: true / false
}
扩展
基于 回收->清洗->推送
这个流程可以进行业务定制化能力的扩展。
比如数据清洗环节,可以进行字段授权或者推送字段的筛选。比如推送环节可以增加消息通知等。