查询基础认证资质

接口说明

该接口用于获取实体基础认证资质信息

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

前提条件

实体ID 已经存在

注意事项

基础认证中的营业执照/个人身份证号唯一标识一个实体，相同实体不可重复入驻。
若未做额外备注，string 类型的默认字段默认支持字符集 utf-8
access_token获取的方式获取access_token

基本信息

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

individual、legal_person、employee_material 说明

参数名	参数类型	是否必须	备注
name	string	是	个人姓名，需要和身份证一致，字符长度限制 2<= len(name) <=30（汉字占2字符）
id_number	string	是	身份证号码
expire_time	string	是	身份证有效期示例：2034-01-09
front_path	string	是	身份证正面链接,人像面
back_path	string	是	身份反面链接,国徽面

class_auth 说明

实体类目认证信息

参数名	参数类型	是否必须	备注
industry_code	int	是	行业编码，目前仅支持泛知识，对应编码为10000
industry_class		是	行业类目
industry_role	int	是	行业角色 1：老师 2：机构 3：代运营服务商
qualification	Array	是	老师角色:老师对应的资质机构角色:机构下老师的资质信息
institution		否	机构角色，该字段必填
partner		否	服务商角色，该字段必填

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		是	机构和员工合作协议

partner 说明

参数名	参数类型	是否必须	备注
company_type	int	是	服务商营业执照企业类型(仅可填写"企业工商户"或"个体工商户")
company_addr	string	是	企业注册地址
cooperation_case	Array	是	服务商合作案例,按理资料pdf

certificate_materials、qualification、cooperation_agreement 、cooperation_case 说明

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

online_qualification、audit_qualification 说明

参数名	参数类型	是否必须	备注
audit_taskid	string	是	资质审核任务ID
audit_status	string	是	资质审核状态 1：审核中 2：审核成功 3：审核失败
qualifications	Array	是	资质材料
audit_reason	string	是	审核失败时原因
expire_time	string	是	资质材料中最大的过期时间，示例：2022-10-10

certificate_materials、qualifications 说明

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

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

curl --location --request POST 'https://developer.toutiao.com/auth/entity/get_basic_auth' \ --header 'Aweme-Check-Type;' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "appid": "tta12xxxxxcbe01", "access_token": "080yyyyyyy35494e62413d3d", "entity_id": "E_7178703725698269228" }'

{ "audit_qualification": {}, "auth_reason": "string", "auth_status": 0, "basic_auth": { "certificate_type": 0, "enterprise": { "certificate_id": "string", "certificate_materials": [ { "material_expiretime": "string", "material_paths": [ "string" ], "material_type": 0 } ], "legal_person": { "back_path": "string", "expire_time": "string", "front_path": "string", "id_number": "string", "name": "string" } }, "entity_name": "string", "entity_type": 0, "individual": {} }, "err": { "err_code": 0, "err_msg": "string" }, "online_qualification": { "audit_reason": "string", "audit_status": 0, "audit_taskid": "string", "expire_time": "string", "qualifications": [ { "material_expiretime": "string", "material_paths": [ "string" ], "material_type": 0 } ] } }

查询基础认证资质

接口说明

注意事项

基本信息

请求参数

返回响应