You need to enable JavaScript to run this app.
导航

订阅推送飞书消息撤回

最近更新时间2023.12.12 14:52:20

首次发布时间2023.12.12 14:52:20

1. 概述

针对部分特殊或重要的仪表盘,为了避免数据在并未刷新或有其他数据异常的情况下进行订阅消息的推送,产品支持订阅消息撤回的能力。目前撤回的方式通过提供接口的方式解决,用户可以在需要撤回的时候输入参数进行接口的调用来撤回相关的飞书消息。本能力仅仪表盘管理员、订阅创建者、项目管理员可使用。如需获得该能力,请您联系贵公司的客户成功经理。

2. 订阅推送飞书消息撤回

接口路由
POST aeolus/api/v3/subscription/withdraw
请求:

{
  "subscription_id":27593, // 订阅id
  "subscribers": [], // 需要撤回指定用户的推送时,指定用户列表
  "after_push_time": "07:01:01" // 可选,设置从当天几点之后的的消息进行撤回
}

响应:

// 执行成功时
{
    "code": "aeolus/ok",
    "data": {
        "subscriptionId": 27594,
        "withdrawStatus": [
            {
                "errCode": 0,
                "errMsg": null,
                "messageId": "om_4907b386b3f0a0e4492773b1508f3634",
                "pushEndTime": "2023-10-13T03:38:38Z",
                "pushInstanceId": 437131,
                "status": "success",
                "subscriber": "xiahaitao"
            },
            {
                "errCode": 0,
                "errMsg": null,
                "messageId": "om_40265c9f9ed5449ce7eb568299407fc9",
                "pushEndTime": "2023-10-13T03:38:39Z",
                "pushInstanceId": 437131,
                "status": "success",
                "subscriber": "xiangbowen"
            }
        ]
    },
    "msg": "成功"
}
// 请求id无权限时
{
    "code": "aeolus/user/unauthorized",
    "detail": {
        "detail": null,
        "reasons": [
            "用户无权限"
        ],
        "suggestions": []
    },
    "extra_msg": "",
    "msg": "用户无权限",
    "queryHistoryId": 0
}
//请求失败时
{
    "code": "aeolus/subscribe/subscribeWithdrawError",
    "extra_msg": {
        "code": -1,
        "msg": "不支持该类型的订阅推送撤回"
    },
    "msg": "请求订阅服务错误:不支持该类型的订阅推送撤回",
    "queryHistoryId": 0
}