批量推送消息

POST

/message/batch

批量推送（fan-out 场景）：messages ≤50 条，每条与 POST /message 完全同构（含各自的 emoo_user_id / thread_key）。

逐条处理，不整体原子：逐条校验落库、逐条返回结果，部分失败不影响其他条；每条独立事务 + 独立 WebSocket 提醒。

限流按条计数：整体请求先消耗 len(messages) 次配额（默认 300 次/分钟，工作区可配置），超限整体拒绝（4154 + retry_after），无部分成功。

服务间调用：OAuth Client 无用户身份即可调用（无需 Emoo-User-Id）；API Key 需绑定用户具备 WS_MESSAGE ADD 权限。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
    "messages": [
        {
            "emoo_user_id": "ou_aaa",
            "message_type": "normal",
            "content": "审批单 OA-8821 等待您审批",
            "thread_key": "oa:approval-8821:user:ou_aaa",
            "due_at": "2026-09-10T18:00:00+08:00",
            "normal_message_info": {
                "from_title": "OA 系统",
                "detail_link": "https://oa.example.com/detail/8821"
            }
        },
        {
            "emoo_user_id": "ou_bbb",
            "message_type": "normal",
            "content": "审批单 OA-8821 等待您审批",
            "thread_key": "oa:approval-8821:user:ou_bbb",
            "due_at": "2026-09-10T18:00:00+08:00",
            "normal_message_info": {
                "from_title": "OA 系统",
                "detail_link": "https://oa.example.com/detail/8821"
            }
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app.emooai.com/open-api/v1/message/batch' \
--header 'Emoo-User-Id: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "messages": [
        {
            "emoo_user_id": "ou_aaa",
            "message_type": "normal",
            "content": "审批单 OA-8821 等待您审批",
            "thread_key": "oa:approval-8821:user:ou_aaa",
            "due_at": "2026-09-10T18:00:00+08:00",
            "normal_message_info": {
                "from_title": "OA 系统",
                "detail_link": "https://oa.example.com/detail/8821"
            }
        },
        {
            "emoo_user_id": "ou_bbb",
            "message_type": "normal",
            "content": "审批单 OA-8821 等待您审批",
            "thread_key": "oa:approval-8821:user:ou_bbb",
            "due_at": "2026-09-10T18:00:00+08:00",
            "normal_message_info": {
                "from_title": "OA 系统",
                "detail_link": "https://oa.example.com/detail/8821"
            }
        }
    ]
}'

返回响应

🟢200

application/json

整体受理成功（code=200，逐条成败看 results）。单条业务错误码与 POST /message 相同（4006/4012/4015/4045/4081/4084/4092），单条校验失败 code=400。

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "success_count": 1,
        "failure_count": 1,
        "results": [
            {
                "index": 0,
                "code": 200,
                "message": "success",
                "data": {
                    "item_id": 1001,
                    "chat_id": null,
                    "chat_message_id": null
                }
            },
            {
                "index": 1,
                "code": 4012,
                "message": "data_not_found",
                "data": {
                    "emoo_user_id": "ou_xxx"
                }
            }
        ]
    }
}

🟠400

🟠401

🟠429

修改于 2026-09-10 01:39:24

批量核销/复活工作项

对账查询