代运营服务商帮老师或代运营模式机构入驻
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://developer.toutiao.com/auth/entity/bypartner
接口说明
该接口用于服务商帮助老师或机构入驻,调用成功过后,基础认证资质和角色下类目认证资质(服务商没有该信息)都会进审,接口返回实体的唯一标识 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 | 是 | 材料链接,字符串数组 |
请求示例请求示例
Shell
JavaScript
Java
Swift
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"
]
}
}
}
}
}'
响应示例响应示例
{
"basic_auth_taskid": "string",
"class_auth_taskid": "string",
"entity_id": "string",
"err": {
"err_code": 0,
"err_msg": "string"
}
}
请求参数
Header 参数
Content-Type
string
必需
Aweme-Check-Type
string
可选
Body 参数application/json