新建招聘官网用户

注册指定招聘官网的用户，注册完成后，可通过根据简历附件创建招聘官网投递任务创建官网投递任务，或通过新建招聘官网投递创建官网投递

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/hire/v1/websites/:website_id/site_users
HTTP Method	POST
接口频率限制	10 次/秒
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	hire:site 更新官网信息

请求头

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

路径参数

名称	类型	描述
website_id	string	官网 ID，可通过获取招聘官网列表获取 示例值："1618209327096"

请求体

名称	类型	必填	描述
name	string	否	用户姓名 示例值："张敏"
email	string	否	用户邮箱 示例值："zhangmin@163.com"
external_id	string	是	外部 ID，幂等字段，同一外部 ID只会创建1个官网用户；当系统中已存在external_id对应的官网用户时，接口会返回已存在的官网用户信息 示例值："6960663240925956621"
mobile	string	否	电话，若填写了该字段，国家码(mobile_country_code)字段必填 示例值："182900291190"
mobile_country_code	string	否	国家码，若填写了该字段，电话（mobile）字段必填，可通过获取地点列表获取 示例值："CN_1"

请求体示例

{
    "name": "张敏",
    "email": "zhangmin@163.com",
    "external_id": "6960663240925956621",
    "mobile": "182900291190",
    "mobile_country_code": "CN_1"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ site_user	website_user	官网用户信息
└ user_id	string	官网用户 ID
└ name	string	用户姓名
└ email	string	用户邮箱
└ external_id	string	外部 ID
└ mobile	string	电话
└ mobile_country_code	string	国家码

响应体示例

{
    "code": 0,
    "msg": "ok",
    "data": {
        "site_user": {
            "user_id": "6960663240925956620",
            "name": "dan27",
            "email": "dan27@163.com",
            "external_id": "6960663240925956621",
            "mobile": "182900291190",
            "mobile_country_code": "CN_1"
        }
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1002001	系统错误	请根据实际报错信息定位或咨询技术支持
400	1002002	参数错误	检查参数是否正确，例如类型，大小