Skip to content

创建背调套餐和附加调查项

在指定背调帐号下创建可用的背调套餐列表和附加调查项信息列表。该接口为增量创建,每次调用会在原有的套餐列表和附加调查项列表基础上新增。

注意事项

已经创建过的套餐 ID和附加调查项 ID无法重复创建,如需修改,请使用更新背调套餐和附加调查项删除背调套餐和附加调查项接口进行操作。

请求

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

请求头

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

请求体

名称类型必填描述
account_idstring背调账号 ID,可通过账号绑定事件获取
示例值:"6995842370159937061"
package_listeco_background_check_package_data\[\]背调套餐列表
  └ idstring套餐 ID。由调用方自定义 注意:长度不超过36字符
示例值:"pkg001"
  └ namestring套餐名称
示例值:"基础套餐"
数据校验规则
- 最大长度:100 字符
  └ descriptionstring套餐描述
示例值:"工作履历信息验证X1,工作表现鉴定评价X1,教育背景核实,公民身份信息验证,简历对比,民事诉讼调查"
additional_item_listeco_background_check_package_additional_item\[\]附加调查项列表
  └ idstring附件调查项 ID。由调用方自定义 注意:长度不超过36字符
示例值:"ext001"
  └ namestring附加调查项名称
示例值:"工作履历信息验证X2"
  └ descriptionstring附加调查项描述
示例值:"详细调查"

请求体示例

json
{
    "account_id": "6995842370159937061",
    "package_list": [
        {
            "id": "pkg001",
            "name": "基础套餐",
            "description": "工作履历信息验证X1,工作表现鉴定评价X1,教育背景核实,公民身份信息验证,简历对比,民事诉讼调查"
        }
    ],
    "additional_item_list": [
        {
            "id": "ext001",
            "name": "工作履历信息验证X2",
            "description": "详细调查"
        }
    ]
}

响应

响应体

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

响应体示例

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

错误码

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

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