竹云IDaaS•开放平台
员工身份(EIAM)

根据外部待办id查询待办

接口

# 权限

身份管理API是以应用维度授权的，在调用接口前需为不同的应用设置接口权限，详情请参考API权限。

权限代码 描述
app_todo_msg 应用侧任务待办管理权限
all 全部接口读写权限

# 请求说明

GET https://{your_domain}/api/v2/tenant/todo/task/sources/{external_id}

# 请求头

参数名 中文名称 必须 类型 描述
Authorization 授权 是 String 格式：Bearer {access_token}
Content-Type 内容类型 是 String 固定值：application/json; charset=utf-8

# 请求示例

无

# 请求参数

参数名 中文名称 必须 类型 描述
external_id 外部待办ID 是 String 第三方应用生成的待办ID

# 返回示例

成功示例：
HTTP/1.1 200 OK
Content-Type: application/json
{
    "id": "20220809162630548-9D52-E085BA68A",
    "source_id": "20220119111936362-77E4-C4A94DFC6",
    "source_type": "APP",
    "title": "待办标题67",
    "content": "待办内容67",
    "message_type": "TEXT",
    "external_id": "67",
    "detail_url": {
        "web_url": "https://www.baidu.com/",
        "mobile_url": "https://www.baidu.com/"
    },
    "user_id": "20220615161810047-F95F-B61E1C44F",
    "deal": false,
    "dealt_at": null,
    "ending_at": "2022-08-14 12:00:00",
    "created_at": "2022-08-09 16:26:30.548",
    "updated_at": "2022-08-09 16:26:30.548"
}


错误示例：
HTTP/1.1 400 Bad Request
{
  "error_code": "TODOTASK.0001",
  "error_msg": "待办不存在"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# 返回参数

参数名 中文名称 类型 描述
id 主键ID String 主键ID，唯一
source_id 来源ID String 来源ID
source_type 来源类型 String SYSTEM=系统 APP=应用
title 标题 String 标题
content 内容 String 内容
message_type 消息类型 String TEXT=文本 MARKDOWN=markdown
created_at 创建时间 String 创建时间
updated_at 修改时间 String 修改时间
dealt_at 处理时间 String 处理时间
ending_at 截止时间 String 截止时间
userId 用户ID String 用户ID
deal 处理状态 Boolean 处理状态
external_id 外部待办ID String 第三方待办的ID
detail_url 待办事件跳转的url Map 包括pc端和mobile的url
--web_url pc端url String pc端url
--mobile_url 手机端url String 手机端url

# 错误码

状态码 错误码 错误信息 处理措施
402 TODOTASK.0001 待办不存在 请检查对应待办是否存在
Todo does not exist

修改待办处理状态