对账查询 - EMOO开放平台

按 thread_keys（≤100，去重保序）返回各收件人的工作项状态。两个用途：重试前查重（该 key 是否已推过、落给了谁）与状态对账（分批扫全量 key 对比 outbox）。

done_source 区分完成来源：source=源系统核销、user=用户个人勾掉（用户勾掉≠已处理，催办名单应包含 status=pending 或 done_source=user 的收件人）、null=未完成。

返回按请求顺序包含全部请求 key，从未推送过的 key 返回空 items；items 不分页（条目数 = 当初推送的 fan-out 人数）。

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "thread_keys": [
        "oa:approval-8821",
        "oa:approval-8822",
        "oa:approval-9999"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

成功（code=200）或业务错误（HTTP 仍 200）。可能错误码：

4006 workspace_not_found

4015 invalid_params（data.reason=thread_key_required，thread_keys 全为空白）

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "results": [
            {
                "thread_key": "oa:approval-8821",
                "items": [
                    {
                        "emoo_user_id": "ou_aaa",
                        "item_id": 1001,
                        "status": "pending",
                        "has_read": false,
                        "done_source": null,
                        "due_at": "2026-09-10T10:00:00Z",
                        "updated_at": "2026-09-09T09:00:00Z"
                    },
                    {
                        "emoo_user_id": "ou_bbb",
                        "item_id": 1002,
                        "status": "done",
                        "has_read": true,
                        "done_source": "user",
                        "due_at": "2026-09-10T10:00:00Z",
                        "updated_at": "2026-09-09T10:00:00Z"
                    }
                ]
            },
            {
                "thread_key": "oa:approval-9999",
                "items": []
            }
        ]
    }
}

🟠400

🟠401

🟠429