更新类目认证资质
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://developer.toutiao.com/auth/entity/update_class_auth
接口说明
该接口用于更新实体类目认证资质
创建沙盒环境小程序时请选择“正式小程序能力映射”,详情请关注行业角色系统能力文档。
前提条件
- 实体ID 已经存在
- 开发者需要在开发者运营平台完成主体认证(入驻开发者平台)
注意事项
- 若未做额外备注,string 类型的默认字段默认支持字符集 utf-8
- access_token获取的方式 获取access_token
- 如果存量的课程资质已经通过新的角色系统进行了修改,那么后续该资质就无法在课程资质系统内再进行修改。
基本信息
基本 | |
---|---|
HTTP URL | 正式环境:https://developer.toutiao.com/auth/entity/update_class_auth 沙盒环境:https://open-sandbox.douyin.com/auth/entity/update_class_auth |
HTTP Method | POST |
权限要求 | AccessToken鉴权 |
partner 说明
参数名 | 参数类型 | 是否必须 | 备注 |
---|---|---|---|
company_type | string | 是 | 企业工商户/个体工商户 |
company_addr | string | 是 | 营业执照上公司地址 |
cooperation_cases | Array | 是 | 合作案例资料图片。 |
institution 说明
机构类目认证信息
参数名 | 参数类型 | 是否必须 | 备注 |
---|---|---|---|
record_name | string | 是 | 机构备案名称,需要与营业执照名称一致或有名称关键词,字符长度限制4<=len<= 1000(汉字占 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 | 是 | 机构和员工合作协议 |
employee_material 说明
参数名 | 参数类型 | 是否必须 | 备注 |
---|---|---|---|
name | string | 是 | 个人姓名,需要和身份证一致,字符长度限制 2<= len(name) <=30(汉字占2字符) |
id_number | string | 是 | 身份证号码 |
expire_time | string | 是 | 身份证有效期 示例:长期有效;2034-01-09 |
front_path | string | 是 | 身份证正面链接,人像面 |
back_path | string | 是 | 身份反面链接,国徽面 |
merchant_qualifications、qualification、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/update_class_auth' \
--header 'Aweme-Check-Type;' \
--header 'Content-Type: application/json' \
--data-raw '// 服务商代老师更新类目认证资质
{
"appid": "tt81xxxxx9801",
"access_token": "yyyy",
"partner_entity_id": "E_7177350732142854188",
"merchant_entity_id": "I_7177356117591244844",
"industry_code": 10000,
"class": {
"first_class": 40000,
"second_class": 40600,
"third_class": 0
},
"industry_role": 1,
"merchant_qualifications": [
{
"material_type": 1003,
"material_expiretime": "",
"material_paths": [
"certification/resource/74ed50a56eaa6782d96a55f157974720"
]
}
]
}
// 自营机构更新实体类目认证资质
{
"appid": "tt81xxxxx9801",
"access_token": "yyyy",
"partner_entity_id": "",
"merchant_entity_id": "I_7177356117591244844",
"industry_code": 10000,
"class": {
"first_class": 40000,
"second_class": 40600,
"third_class": 0
},
"industry_role": 2,
"merchant_qualifications": [
{
"material_type": 1003,
"material_expiretime": "",
"material_paths": [
"certification/resource/74ed50a56eaa6782d96a55f157974720"
]
}
],
"institution": {
"record_name": "xxx合作优先公司",
"scene_type": "线上机构",
"subject_type": "企业工商户",
"logo_uri": "certification/resource/74ed50a56eaa6782d96a55f15xxx",
"trademark_uri": "certification/resource/74ed50a56eaa6782d96a55f1579yyy",
"desc": "机构描述",
"employee": {
"employee_material": {
"name": "王xx",
"id_number": "411938171723773",
"expire_time": "2033-10-10",
"front_path": "certification/resource/74ed50a56eaa6782d96a55f15xxxx",
"back_path": "certification/resource/74ed50a56eaa6782d96a55f157xxxxx"
},
"cooperation_agreement": {
"material_type": 1005,
"material_expiretime": "2023-10-10",
"material_paths": [
"certification/resource/74ed50a56eaa6782d96xxxxf157xxxxx"
]
}
}
}
}'
响应示例响应示例
{
"class_auth_taskid": "string",
"err": {
"err_code": 0,
"err_msg": "string"
}
}
请求参数
Header 参数
Content-Type
string
必需
Aweme-Check-Type
string
可选
Body 参数application/json