该接口用于服务商帮助老师或机构入驻,调用成功过后,基础认证资质和角色下类目认证资质(服务商没有该信息)都会进审,接口返回实体的唯一标识 entity_id 以及审核 ID,审核通过后资质生效。
创建沙盒环境小程序时请选择“正式小程序能力映射”,详情请关注行业角色系统能力文档。
| 基本 | |
|---|---|
| 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 '/auth/entity/bypartner' \
--header 'Aweme-Check-Type;' \
--header 'Authorization: Bearer <token>' \
--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"
]
}
}
}
}
}'{
"basic_auth_taskid": "string",
"class_auth_taskid": "string",
"entity_id": "string",
"err": {
"err_code": 0,
"err_msg": "string"
}
}