# 更新背调订单进度

更新指定背调订单的进度信息和阶段性报告，进度信息将会被展示在「飞书招聘」-「投递详情页」-「背调卡片」上，告知用户目前背调订单的流转状态。

**注意事项**：当订单状态已完成时，将无法通过此接口更新进度信息和阶段报告。

## 请求

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/hire/v1/eco_background_checks/update_progress
HTTP Method | POST
接口频率限制 | [1000 次/分钟、50 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 更新招聘背调信息(hire:background_check_order)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 请求体

名称 | 类型 | 必填 | 描述
---|---|---|---
background_check_id | string | 是 | 背调 ID。可通过[创建背调](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_background_check/events/created)事件获取<br>**示例值**："6931286400470354183"
stage_id | string | 是 | 阶段 ID。同一背调订单此 ID 不能重复，由调用方自定义<br>**示例值**："6931286400470354183"
stage_en_name | string | 否 | 背调阶段英文名称<br>**示例值**："stage report"
stage_name | string | 是 | 背调阶段名称<br>**示例值**："阶段报告"
stage_time | string | 是 | 阶段进度更新时间。 毫秒时间戳，每次调用此字段应严格递增<br>**示例值**："1660123456789"
result | string | 否 | 背调结果（阶段性背调结果）。<br>**注意**：若需回传该字段，report_file_list为必填<br>**示例值**："通过"
report_file_list | eco_background_check_report_file\[\] | 否 | 报告列表
report_name | string | 是 | 报告名称<br>**示例值**："阶段报告.pdf"
report_url | string | 是 | 报告地址；当report_url_type 为空或为 1 时需为可下载的 pdf 链接；为 2 时为预览型链接<br>**示例值**："https://xxxxx/xxxxxx/xxxx.pdf"
report_url_type | int | 否 | 报告地址类型；枚举值为空或 1 时为可下载的 pdf 链接，2 为预览型链接<br>**示例值**：1<br>**可选值有**：<br>- 1：可下载的链接<br>- 2：预览型链接

### 请求体示例
```json
{
    "background_check_id": "6931286400470354183",
    "stage_id": "6931286400470354183",
    "stage_en_name": "stage report",
    "stage_name": "阶段报告",
    "stage_time": "1660123456789",
    "result": "通过",
    "report_file_list": [
        {
            "report_name": "阶段报告.pdf",
            "report_url": "https://xxxxx/xxxxxx/xxxx.pdf",
            "report_url_type": 1
        }
    ]
}
```

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-

### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {}
}
```

### 错误码

HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 1002858 | 订单状态异常 | 请检查参数
400 | 1002862 | 背调订单不存在 | 请检查入参`background_check_id`
500 | 1002001 | 系统异常 | 请根据实际报错信息定位问题或联系[技术支持](https://applink.feishu.cn/TLJpeNdW)