同步三方审批实例
POST
https://open.feishu.cn/open-apis/approval/v4/external_instances
需确保审批实例内各类唯一ID在审批实例内的唯一性，即使不属于同一实体。实体包括：实例(instance)、任务(task)、抄送(cc)。如果实例ID、任务ID、抄送ID重复，则会导致在审批中心任务看不到对应的待办、已办、抄送、已发起数据。
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 1390001 | param is invalid | 参数错误 |
| 400 | 1395001 | There have been some errors. Please try again later | 服务出现错误，请稍候再试 |
| 400 | 1390014 | Do not synchronize the same approval instance for a short period of time! | 短时间内不要同步相同的审批实例 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.feishu.cn/open-apis/approval/v4/external_instances' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"approval_code": "84C18825-A3D2-41D0-891F-E7A2424C5D48",
"instance_id": "3162634",
"status": "PENDING",
"extra": "",
"links": {
"pc_link": "http://applink.feishu.cn/sso/common?redirectUrl=/seeyon/main.do?method=main&client=pc",
"mobile_link": "http://applink.feishu.cn/sso/common?redirectUrl=/seeyon/main.do?method=main&client=pc"
},
"title": "@i18n@1",
"form": [{
"name": "@i18n@2",
"value": "@i18n@3"
}],
"user_id": "16fb9ff3",
"user_name": "张三",
"open_id": "123",
"department_id": "",
"department_name": "hr",
"start_time": "1657093395000",
"update_time": "1657093395000",
"end_time": 0,
"update_mode": "REPLACE",
"task_list": [{
"task_id": "112253",
"user_id": "16fb9ff3",
"links": {
"pc_link": "http://",
"mobile_link": "http://"
},
"status": "PENDING",
"extra": "",
"title": "同意",
"create_time": "1638468921000",
"end_time": 0,
"update_time": "1638468921000",
"action_context": "123456",
"action_configs": [{
"action_type": "APPROVE",
"action_name": "@i18n@1",
"is_need_reason": true,
"is_reason_required": true,
"is_need_attachment": true
}]
}],
"cc_list": [{
"cc_id": "1231243",
"user_id": "16fb9ff3",
"open_id": "",
"links": {
"pc_link": "http://",
"mobile_link": "http://"
},
"read_status": "READ",
"extra": "",
"title": "XXX",
"create_time": "1657093395000",
"update_time": "1657093395000"
}],
"i18n_resources": [{
"locale": "zh-CN",
"is_default": true,
"texts": [ {"key":"@i18n@1", "value":"测试"}, {"key":"@i18n@2", "value":"天"},{"key":"@i18n@3", "value":"2022-07-06"}]
}]
}'响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {
"data": {
"approval_code": "81D31358-93AF-92D6-7425-01A5D67C4E71",
"status": "PENDING",
"extra": "{\"xxx\":\"xxx\",\"business_key\":\"xxx\"}",
"instance_id": "24492654",
"links": {
"pc_link": "https://applink.feishu.cn/client/mini_program/open?mode=appCenter&appId=cli_9c90fc38e07a9101&path=pc/pages/detail?id=1234",
"mobile_link": "https://applink.feishu.cn/client/mini_program/open?appId=cli_9c90fc38e07a9101&path=pages/detail?id=1234"
},
"title": "@i18n@1",
"form": [
{
"name": "@i18n@2",
"value": "@i18n@3"
}
],
"user_id": "a987sf9s",
"user_name": "@i18n@9",
"open_id": "ou_be73cbc0ee35eb6ca54e9e7cc14998c1",
"department_id": "od-8ec33278bc2",
"department_name": "@i18n@10",
"start_time": "1556468012678",
"end_time": "1556468012678",
"update_time": "1556468012678",
"display_method": "BROWSER",
"update_mode": "UPDATE",
"task_list": [
{
"task_id": "112534",
"user_id": "a987sf9s",
"open_id": "ou_be73cbc0ee35eb6ca54e9e7cc14998c1",
"title": "i18n1",
"links": {
"pc_link": "https://applink.feishu.cn/client/mini_program/open?mode=appCenter&appId=cli_9c90fc38e07a9101&path=pc/pages/detail?id=1234",
"mobile_link": "https://applink.feishu.cn/client/mini_program/open?appId=cli_9c90fc38e07a9101&path=pages/detail?id=1234"
},
"status": "PENDING",
"extra": "{\"xxx\":\"xxx\",\"complete_reason\":\"approved\"}",
"create_time": "1556468012678",
"end_time": "1556468012678",
"update_time": "1556468012678",
"action_context": "123456",
"action_configs": [
{
"action_type": "APPROVE",
"action_name": "@i18n@5",
"is_need_reason": false,
"is_reason_required": false,
"is_need_attachment": false
}
],
"display_method": "BROWSER",
"exclude_statistics": false,
"node_id": "node",
"node_name": "i18n@name"
}
],
"cc_list": [
{
"cc_id": "123456",
"user_id": "12345",
"open_id": "ou_be73cbc0ee35eb6ca54e9e7cc14998c1",
"links": {
"pc_link": "https://applink.feishu.cn/client/mini_program/open?mode=appCenter&appId=cli_9c90fc38e07a9101&path=pc/pages/detail?id=1234",
"mobile_link": "https://applink.feishu.cn/client/mini_program/open?appId=cli_9c90fc38e07a9101&path=pages/detail?id=1234"
},
"read_status": "READ",
"extra": "{\"xxx\":\"xxx\"}",
"title": "xxx",
"create_time": "1556468012678",
"update_time": "1556468012678",
"display_method": "BROWSER"
}
],
"i18n_resources": [
{
"locale": "zh-CN",
"texts": [
{
"key": "@i18n@1",
"value": "people"
}
],
"is_default": true
}
],
"trusteeship_url_token": "788981c886b1c28ac29d1e68efd60683d6d90dfce80938ee9453e2a5f3e9e306",
"trusteeship_user_id_type": "user_id",
"trusteeship_urls": {
"form_detail_url": "https://#{your_domain}/api/form_detail",
"action_definition_url": "https://#{your_domain}/api/action_definition",
"approval_node_url": "https://#{your_domain}/api/approval_node",
"action_callback_url": "https://#{your_domain}/api/action_callback",
"pull_business_data_url": "https://#{your_domain}/api/pull_business_data"
}
}
}
}请求参数
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
Content-Type
string
必需
默认值:
application/json; charset=utf-8
Body 参数application/json
返回响应
扫码加入交流群修改于 2023-02-02 03:41:57