批量核销/复活工作项 - EMOO开放平台

源系统回调：按 thread_keys（≤100，去重保序，逐 key 独立）批量核销/复活工作项，幂等（重复调用安全，只更新需要变更的条目）。

resolved：源系统已办结 → 该 thread_key 在当前 workspace 下所有用户的待处理条目自动标记 done（核销，done_source=source）

reopened：源系统撤回/重开 → 已完成条目回到待处理并重置未读（浮回找上门）

注意：重推同 thread_key 也会复活对应收件人的条目（内容有变化时用重推，内容没变才用 reopened）。

业务状态的权威永远在源系统，emoo 只维护「我的列表还显不显示」。

服务间调用：OAuth Client 无用户身份即可调用（无需 Emoo-User-Id）；API Key 调用需绑定用户具备 WS_MESSAGE ADD 权限，与推送对齐——能推送的才能核销/复活。范围限定在当前 workspace。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

办结核销（批量）撤回重开

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

请求示例代码

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",
                "status": "done",
                "updated_count": 3
            },
            {
                "thread_key": "oa:approval-8822",
                "status": "done",
                "updated_count": 1
            }
        ]
    }
}

🟠400

🟠401

🟠429