Skip to content

创建试卷列表

飞书招聘的笔试服务商,在完成账号绑定后,可通过本接口在客户的笔试帐号下创建试卷列表。若客户的笔试账号为「未激活」、「停用」状态,则试卷创建成功后,客户的账号将变为「正常」状态,可正常安排笔试。

Warning: 本接口为全量更新,多次调用时,将生效最后一次调用传入的试卷列表。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/eco_exam_papers
HTTP MethodPOST
接口频率限制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 长度应不超过255字符,超出部分将被截断
示例值:"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系统错误请根据实际报错信息定位问题或联系技术支持

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