Skip to content

更新试卷列表

飞书招聘的笔试服务商,可通过该接口更新客户笔试账号下的试卷列表。

Warning: * 该接口仅支持修改已有试卷信息(通过试卷 ID标识),不支持新增或删除试卷。

  • 修改已有试卷的笔试开始/结束时间,将影响已安排笔试的笔试时间。
  • 此接口为全量更新接口,若字段值为空,则原有值将会清空。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/eco_exam_papers/batch_update
HTTP MethodPATCH
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用hire:exam 更新笔试信息

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

请求体

名称类型必填描述
account_idstring笔试账号 ID,可通过账号绑定事件获取
示例值:"7147998241542539527"
paper_listeco_exam_paper_data\[\]试卷列表
  └ idstring试卷 ID,为通过创建试卷列表传入的 ID
示例值:"7147998241542539527"
数据校验规则
- 最小长度:1 字符
  └ namestring试卷名称 注意:试卷名称长度应不超过255字符,超出部分将被截断
示例值:"春季测评"
数据校验规则
- 最小长度:1 字符
  └ durationint笔试时长(分钟)
示例值:30
  └ question_countint试卷题目数量
示例值:30
  └ start_timestring笔试开始时间,毫秒时间戳。留空或不传表示不限制开始时间。 注意:若传值且end_time不为空,则开始时间必须小于结束时间
示例值:"1658676234053"
  └ end_timestring笔试结束时间,毫秒时间戳。留空或不传表示不限制结束时间 注意:若传值且start_time 不为空,则结束时间必须大于开始时间
示例值:"1672444800000"

请求体示例

json
{
    "account_id": "7147998241542539527",
    "paper_list": [
        {
            "id": "7147998241542539527",
            "name": "春季测评",
            "duration": 30,
            "question_count": 30,
            "start_time": "1658676234053",
            "end_time": "1672444800000"
        }
    ]
}

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--

响应体示例

json
{
    "code": 0,
    "msg": "SUCCESS",
    "data": {}
}

错误码

HTTP状态码错误码描述排查建议
5001002001系统错误请根据实际报错信息定位问题或联系技术支持

内容来源:飞书开放平台 · 自动爬取整理