添加订阅

POST

https://api.huoban.com/openapi/v1/event/subscribe

可以对指定的一个表格订阅数据的创建、修改、删除事件，当数据发生订阅的数据变化后，会将数据内容推送到回调地址。
可以对指定的一个流程订阅流程的发起及变更、任务的发起及变更事件，当流程发生订阅的变化后，会将流程实例及流程任务推送到回调地址。
企业可在企业后台的“接口授权”中的每个 API Key 上设置回调地址，服务商可调用“设置订阅回调地址”的接口设置回调地址。

请求参数

Header 参数

Body 参数application/json

示例

{
    "source_id": "{{TABLE_ID}}",
    "source_type": "table",
    "events": [
        "item.create",
        "item.update",
        "item.delete"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.huoban.com/openapi/v1/event/subscribe' \
--header 'Open-Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "source_id": "",
    "source_type": "table",
    "events": [
        "item.create",
        "item.update",
        "item.delete"
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "subscribe": {
            "source_id": "2100000014303340",
            "source_type": "table",
            "events": [
                "item.update",
                "item.create"
            ],
            "state": 1
        }
    },
    "meta": {
        "trace_id": "1652588545784032"
    }
}

修改于 2025-05-19 03:45:11

订阅回调事件

取消订阅