代运营服务商帮老师或代运营模式机构入驻

接口说明

该接口用于服务商帮助老师或机构入驻，调用成功过后，基础认证资质和角色下类目认证资质(服务商没有该信息)都会进审，接口返回实体的唯一标识 entity_id 以及审核 ID，审核通过后资质生效。

创建沙盒环境小程序时请选择“正式小程序能力映射”，详情请关注行业角色系统能力文档。

前提条件

服务商已经入驻，服务商实体认证已经通过审核
老师或机构对应的实体没有入驻过(如果实体已经存在，可以调用添加类目接口即可)
开发者需要在开发者运营平台完成主体认证(入驻开发者平台)

注意事项

基础认证中的营业执照唯一标识一个实体，相同实体不可重入入驻。可以添加多个类目资质
若想对已经拥有 entity_id 的实体添加一个新的类目，请调用添加类目资质接口
调用入驻接口后，若想对正在审核中的基础认证资质进行修改，请调用基础认证修改接口；若想对正在审核中的类目认证资质进行修改，请调用类目认证修改接口
若未做额外备注，string 类型的默认字段默认支持字符集 utf-8
access_token获取的方式获取access_token
如果存量的课程资质已经通过新的角色系统进行了修改，那么后续该资质就无法在课程资质系统内再进行修改

基本信息

基本
HTTP URL	正式环境：https://developer.toutiao.com/auth/entity/bypartner 沙盒环境：https://open-sandbox.douyin.com/auth/entity/bypartner
HTTP Method	POST
权限要求	AccessToken鉴权

enterprise 说明

企业实体基础认证信息

参数名	参数类型	是否必须	备注
certificate_id	string	是	营业执照编号
certificate_materials	Array	是	营业执照材料信息
legal_person		是	法人信息

institution 说明

机构类目认证信息

参数名	参数类型	是否必须	备注
record_name	string	是	机构备案名称,需要与营业执照名称一致或有名称关键词，字符长度限制4<=len<= 40(汉字占 2 字符)
scene_type	string	是	机构场景类型（仅可填写"线上机构"或"线下机构"）
subject_type	string	是	机构主体类型（仅可填"企业工商户"或"个体工商户"）
logo_uri	string	否	机构Logo图片uri，需要调用上传资源接口后获得
trademark_uri	string	否	商标注册证图片uri，若机构名称与机构logo一致性差，则需提供，需要调用上传后获得
desc	string	是	机构介绍，字符长度限制12<=len<= 200(汉字占 2 字符)
employee		是	机构合作员工信息(泛知识行业是和机构合作的老师信息)

employee 说明

机构合作老师信息

参数名	参数类型	是否必须	备注
employee_material		是	机构员工个人身份信息
cooperation_agreement		是	机构和员工合作协议

partner 说明

参数名	参数类型	是否必须	备注
company_type	string	是	企业工商户/个体工商户
company_addr	string	是	营业执照上公司地址
cooperation_cases	Array	是	合作案例资料图片。

certificate_materials、qualifications、cooperation_agreement 、cooperation_case 说明

参数名	参数类型	是否必须	备注
material_type	int	是	材料类型，目前支持的类型见上传资料接口
material_expiretime	string	是	材料过期时间，示例：2029-09-10
material_paths	Array	是	材料链接，字符串数组

curl --location --request POST 'https://developer.toutiao.com/auth/entity/bypartner' \ --header 'Aweme-Check-Type;' \ --header 'Content-Type: application/json' \ --data-raw '// 服务商帮助个体老师入驻示例 { "appid":"ttxxxxxxxx", "access_token":"xxxxxxxx", "entity_id":"E_7178703725253394476", "basic_auth":{ "entity_type":1, "entity_name":"和xx", "certificate_type":1, "individual":{ "name":"和xx", "id_number":"1405812000xxx54xx3", "expire_time":"2033-01-01", "front_path":"certification/resource/78101ff50a2782ad9be8f72328f0ba81", "back_path":"certification/resource/e288d79c9df794ce0c1660b460082918" } }, "class_auth":{ "industry_code":10000, "industry_class":{ "first_class":40000, "second_class":40600, "third_class":0 }, "industry_role":1, "qualifications":[ { "material_type":1001, "material_expiretime":"2033-01-02", "material_paths":[ "certification/resource/01d86c188a9a6ba4e4bbbe3385ccf1f2" ] } ] } } // 服务商帮助机构入驻示例 { "appid":"tt5ed3286ec1exxxb801", "access_token":"{{accesstoken}}", "entity_id":"E_720848123xxx5589309", "basic_auth":{ "entity_type":2, "entity_name":"企业老师第三阶段内部测试三", "certificate_type":2, "enterprise":{ "certificate_id":"91112022083xxx0762", "certificate_materials":[ { "material_type":1007, "material_expiretime":"2025-01-01", "material_paths":[ "certification/resource/13084f5b17978a5c0f37a1aa9f37e45a" ] } ], "legal_person":{ "name":"花x玲", "id_number":"3206821xxx08139122", "expire_time":"2033-03-04", "front_path":"certification/resource/175e18a5d45fefd6fe4289bc23c1cfe5", "back_path":"certification/resource/e6195fa78c5d125f54348734206417c6" } } }, "class_auth":{ "industry_code":10000, "industry_class":{ "first_class":40000, "second_class":40600, "third_class":0 }, "industry_role":2, "qualifications":[ { "material_type":1001, "material_expiretime":"2033-01-02", "material_paths":[ "certification/resource/41130372b6128175610a417317a398ba" ] } ], "institution":{ "record_name":"内部测试麻烦审核通过", "scene_type":"线上机构", "subject_type":"企业工商户", "logo_uri":"certification/resource/5b3f3a85b6121e4f0439b3d5fb91fbdd", "trademark_uri":"certification/resource/b6fa447d3c7fdf9f99b5421b791c038f", "desc":"哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈", "employee":{ "employee_material":{ "name":"花x玲", "id_number":"3206821xxx08139122", "expire_time":"2033-01-02", "front_path":"certification/resource/175e18a5d45fefd6fe4289bc23c1cfe5", "back_path":"certification/resource/e6195fa78c5d125f54348734206417c6" }, "cooperation_agreement":{ "material_type":1005, "material_expiretime":"2040-02-08", "material_paths":[ "certification/resource/41130372b6128175610a417317a398ba" ] } } } } }'

请求参数

Header 参数

Content-Type

string

必需

请求的MIME类型，统一为application/json

Aweme-Check-Type

string

可选

沙盒环境自动审核参数，REJECT代表审核拒绝，其他代表审核成功

Body 参数application/json

appid

string

小程序appid

必需

access_token

string

必需

小程序的AccessToken

entity_id

string

服务商实体ID

必需

basic_auth

object

实体基础认证信息

必需

entity_type

integer

必需

实体类型 1: 个人 2:企业

entity_name

string

必需

实体名称实体类型为1，该字段为个人姓名，字符长度限制 2<= len(name) <=30（汉字占2字符）实体类型为2，该字段为企业名称，字符长度限制4<=len<= 40(汉字占 2 字符)应当与营业执照上主体名称一致

certificate_type

integer

必需

证件照类型 1：身份证 2：营业执照

individual

object

可选

实体类型为个人，参数必填

class_auth

object

实体类目认证信息

必需

industry_code

integer

必需

行业编码，目前仅支持泛知识，对应编码为10000

industry_class

object

行业类目

必需

industry_role

integer

必需

行业角色 1：老师 2：机构

qualifications

array [object {3}]

必需

老师角色:老师对应的资质机构角色:机构下老师的资质信息

示例

application/json

Body

basic_auth_taskid

string

基础认证任务ID

必需

class_auth_taskid

string

类目认证任务ID

必需

entity_id

string

老师实体ID

必需

err

object

错误信息

必需

err_code

integer

错误码

必需

err_msg

string

错误tips

必需

代运营服务商帮老师或代运营模式机构入驻

接口说明

前提条件

注意事项

基本信息

请求参数

返回响应