查询基础认证资质
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://developer.toutiao.com/auth/entity/get_basic_auth
接口说明
该接口用于获取实体基础认证资质信息
创建沙盒环境小程序时请选择“正式小程序能力映射”，详情请关注行业角色系统能力文档。
前提条件
- 实体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 | 是 | 资质材料链接，字符串数组 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer.toutiao.com/auth/entity/get_basic_auth' \
--header 'Aweme-Check-Type;' \
--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
}
]
}
}请求参数
Header 参数
Content-Type
string
必需
Aweme-Check-Type
string
可选
Body 参数application/json
返回响应
修改于 2023-12-04 06:13:00