【泛知识】查询资质
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://developer-product.zijieapi.com/product/api/query_qualification
接口介绍
接口说明
基本信息
| HTTP URL | 正式环境：https://developer-product.zijieapi.com/product/api/query_qualification 沙盒环境：https://open-sandbox.douyin.com/product/api/query_qualification |
|---|---|
| HTTP Method | POST |
| 权限要求 | AccessToken鉴权 |
qualification--详细资质信息
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| object_type | enum | 资质类型选择：1-老师，2-机构，参见本章节最后枚举说明部分 | 1 |
| object_id | string | 资质ID，由添加接口获取 | "T3253426234322" |
| object_name | string | 资质主体名称，若为教师，则脱敏后显示 | "张*" |
| status | number | 资质当前状态，主要有以下几种情况： 1-资质已上架， 2-资质已失效， 11-资质正在审核中， 12-资质已审核通过， 13-资质审核未通过， 其中，1和2只会出现在qualification_on_shelf中，11、12、13则只出现在qualification_reviewing中 | 11 |
| nick_name | string | 资质主体昵称 | "张三" |
| first_class | number | 行业一级分类 | 30000 |
| second_class | number | 行业二级分类 | 30100 |
| third_class | number | 行业三级分类 | 0 |
| fail_reason | string | 审核失败原因 | "驳回理由是资质信息:营业执照图片不清晰不完整;" |
枚举参数
object_type--资质主体类型
| 资质类型 | 资质编码 |
|---|---|
| 老师 | 1 |
| 机构 | 2 |
qualification -> status--资质主体状态
| 资质主体类型 | 资质主体编码 |
|---|---|
| 已上架 | 1 |
| 已失效 | 2 |
| 正在审核中 | 11 |
| 审核通过 | 12 |
| 审核未通过 | 13 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer-product.zijieapi.com/product/api/query_qualification' \
--header 'Content-Type: application/json' \
--data-raw '{
"access_token": "080112184676444244166471506b427341456a414e5646744d773d3d",
"appid": "tt053873859a00623001",
"object_id_with_classifications": [
{
"object_type": 1,
"object_id": "i7099005143589662723",
"first_class": 0,
"second_class": 0,
"third_class": 0,
"fail_reason": "xxx"
},
{
"object_type": 1,
"object_id": "t7096818881041442963",
"first_class": 70000,
"second_class": 70500,
"third_class": 0,
"fail_reason": "xxx"
},
{
"object_type": 1,
"object_id": "t7097099402900663821",
"first_class": 50000,
"second_class": 50300,
"third_class": 0,
"fail_reason": "xxx"
},
{
"object_type": 1,
"object_id": "t7080104044114242600",
"first_class": 30000,
"second_class": 30100,
"third_class": 0,
"fail_reason": "xxx"
}
]
}'响应示例响应示例
200 - 示例 1
{
"err_no": 0,
"err_msg": "string",
"log_id": "string",
"data": {
"qualifications": [
{
"qualification_on_shelf": {
"third_class": 0,
"object_type": 0,
"object_id": "string",
"status": 0,
"object_name": "string",
"nick_name": "string",
"first_class": 0,
"second_class": 0,
"fail_reason": "string"
},
"qualification_reviewing": {
"object_id": "string",
"status": 0,
"object_name": "string",
"nick_name": "string",
"first_class": 0,
"second_class": 0,
"third_class": 0,
"object_type": 0,
"fail_reason": "string"
}
}
]
}
}请求参数
Header 参数
Content-Type
string
必需
Body 参数application/json