【泛知识】添加资质
接口介绍
该接口用于添加老师/机构的资质，调用成功过后，接口返回资质的唯一表示 object_id，同时资质进审，审核通过后资质生效。
审核结果将通过通知回调接口通知开发者。
使用限制
无
接口说明
前提条件
- 添加的资质必须为首次上传，若要修改已有资质请调用修改资质接口
- 资源 uri 字段的来源于是上传课程资源的返回，需要先调用资源上传接口，收到上传成功回调消息，或者调用资源上传状态查询接口确认状态为上传成功后才有效，否则会报"无效的 uri"错误
注意事项
- 同一个老师，可以添加多个行业资质，但一次只能添加一个行业
- 若想对已经拥有 object_id 的老师添加一个新的行业，请调用修改资质接口
- 调用资质添加接口后，若想对正在审核中的资质进行修改，请调用修改资质接口
- 若未做额外备注，string 类型的默认字段默认支持字符集 utf-8
请求
基本信息
HTTP URL | https://developer-product.zijieapi.com/product/api/add_qualification |
|---|---|
HTTP Method | POST |
权限要求 | AccessToken鉴权 |
请求头
参数名 | 参数类型 | 是否必须 | 备注 | 示例 |
|---|---|---|---|---|
Content-Type | string | 是 | 请求的MIME类型，统一为application/json | "application/json" |
请求参数
参数名 | 参数类型 | 是否必须 | 描述 | 示例 |
|---|---|---|---|---|
access_token | string | 是 | 接口调用凭证 | "0801121846735352506a356a67395167574457583155554e67654321" |
appid | string | 是 | 小程序appid | "tt12fd9846e1023401" |
qualification | Json object | 是 | 相关资质信息 | |
参数说明
qualification--资质信息
参数名 | 参数类型 | 是否必须 | 描述 | 示例 |
|---|---|---|---|---|
object_type | enum | 是 | 资质类型选择：1-老师，2-机构 | 1 |
teacher_qualification_info | object | 否(当object_type=1时必填) | 老师资质审核信息 | |
institution_qualification_info | object | 否(当object_type=2时必填) | 机构资质审核信息 |
|
callback_data | string | 否 | 开发者回调，<= 1024byte | "开发者自定义回调信息" |
teacher_qualification_info--老师资质审核信息
参数名 | 参数类型 | 是否必须 | 描述 | 示例 |
|---|---|---|---|---|
name | string | 是 | 老师姓名 字符长度限制 2 <= len(name) <=30（汉字占2字符） | "张三" |
first_class | number | 是 | 一级商品分类，详见 | 10000 |
second_class | number | 是 | 二级商品分类，详见 | 10100 |
third_class | number | 是 | 三级商品分类，暂时为0 | 0 |
ID_number | string | 是 | 老师身份证号码，要求输入合法的中国大陆身份证号码 | "110101199003071997" |
ID_img_uris | array(string) | 是 | 老师身份证图片uri列表，需要调用上传资源接口后获得uri，要求必须上传正反面身份证图片，数量为2 | |
img_uri | string | 是 | 老师头图uri，需要调用上传资源接口后获得uri，要求大小不得超过5Mb | "tos-boe-i-3rjuffv3j3/710081825fd1dfc9c428fd5e877b0e5e" |
nickname | string | 是 | 老师昵称，用于与课程关联 字符长度限制 2 <= len <=30（汉字占2字符） | "张三" |
introduction | string | 是 | 老师介绍 字符长度限制 1 <= len <=2000（汉字占2字符） | “” |
qualification_info_lst | array | 是 | 资质信息列表 | |
institution_qualification_info--机构资质审核信息
参数名 | 参数类型 | 是否必须 | 描述 | 示例 |
|---|---|---|---|---|
name | string | 是 | 授课机构名称，需要与营业执照名称一致或有名称关键词，字符长度限制4<=len<= 1000(汉字占 2 字符) | "北京******科技有限公司" |
institution_introduction | string | 是 | 机构介绍， 字符长度限制12<=len<= 200(汉字占 2 字符) | "**机构是专注***、内容变现、课程上传、支持***的***" |
company_name | string | 是 | 企业名称，字符长度限制4<=len<= 1000(汉字占 2 字符)应当与营业执照上主体名称一致 | "北京******科技有限公司" |
institution_record_name | string | 是 | 机构备案名称 字符长度限制4<=len<= 1000(汉字占 2 字符) | "北京******科技有限公司" |
institution_scene_type | string | 是 | 机构场景类型（仅可填写"线上机构"或"线下机构"） | "线上机构" |
institution_subject_type | string | 是 | 机构主体类型（仅可填写"企业工商户"或"个体工商户"） | "企业工商户" |
legal_person_name | string | 是 | 机构法人姓名字符长度限制2<=len<=30(汉字占2字符） | "张三" |
legal_person_ID_number | string | 是 | 机构法人身份证号码，要求输入合法的中国大陆身份证号码 | "110101199003071997" |
legal_person_ID_img_uris | array | 是 | 机构法人身份证图片uri列表，需要调用上传后获得，要求必须上传正反面身份证图片，数量为2 | |
institution_logo_uri | string | 否 | 机构Logo图片uri，需要调用上传资源接口后获得 | "product/resource/qualification1.jpg" |
institution_trade_mark_uri | string | 否 | 商标注册证图片uri，若机构名称与机构logo一致性差，则需提供，需要调用上传后获得 | "product/resource/qualification1.jpg" |
img_uri | string | 是 | 机构头图uri，需要调用上传资源接口后获得uri，要求大小不得超过5Mb | "tos-boe-i-3rjuffv3j3/710081825fd1dfc9c428fd5e877b0e5e" |
nickname | string | 是 | 机构昵称，用于与课程关联 字符长度限制 2 <= len <=30（汉字占2字符） | "张三" |
qualification_info_lst | array | 是 | 资质信息列表 | |
qualification_info--资质详情
填写具体的资质信息，包括资质图片、资质有效期等。若主体类型为机构，则必须填写 licenseId。
参数名 | 参数类型 | 是否必须 | 描述 | 示例 |
|---|---|---|---|---|
type | enum | 是 | 资质相关类型，有如下类型：1:机构营业许可证2:教师资格证3:专业性学历证书4:专业认证其中，当资质主体类型为机构时选择1，为老师时，2、3、4中至少填一个 | 1 |
image_uris | array(string) | 是 | 资质图片uri列表，uri需要调用上传后获得，可以上传多张图片，图片总大小不可超过100MB | |
validity_date | string | 是 | 资质有效期，要求填格式为"2006-01-02"的日期字符串或"长期有效"，若填写日期，有效期不得短于3个月 | "2022-12-20"或"长期有效" |
license_id | string | 否（若type=1则必填） | 仅含数字和大写字母短字符串 长度 10<= len(license_id)<=20 | "91111234567812N17U" |
示例
{
"access_token": "0801121846742b4c56762b6f5a4a3636527747714c39334950773d3d",
"appid": "tt5daf2b12c2857910",
"qualification": {
"object_type": 2,
"institution_qualification_info": {
"name": "北京******科技有限公司",
"institution_introduction": "****是专注抖音知识付费、内容变现、课程上传、支持短视频直播挂载的小程序",
"company_name": "哈哈哈ha",
"institution_record_name": "哈哈哈",
"institution_scene_type": "线上机构",
"institution_subject_type": "企业工商户",
"legal_person_name": "张三",
"legal_person_ID_number": "110101199003079315",
"legal_person_ID_img_uris": [
"product/resource/002b47258345646892b517009a473630",
"product/resource/002b47258345646892b517009a473630"
],
"institution_logo_uri": "product/resource/002b47258345646892b517009a473630",
"institution_trade_mark_uri": "product/resource/002b47258345646892b517009a473630",
"qualification_info_lst": [
{
"type": 1,
"image_uris": ["product/resource/002b47258345646892b517009a473630"],
"validity_date": "2022-09-21",
"license_id": "2352WE600099"
}
],
"img_uri": "tos-boe-i-3rjuffv3j3/710081825fd1dfc9c428fd5e877b0e5e",
"nickname": "张三"
}
}
}响应
响应体
参数名 | 参数类型 | 描述 | 示例 |
|---|---|---|---|
err_no | number | 错误码，0为成功 | 0 |
err_msg | string | 错误内容 | "success" |
log_id | string | 日志id，用于查询错误 | "101210271802130982251451520919C123" |
data | object | 返回数据，成功后返回审核主体id，即object_id，其中，T开头表示老师，I开头表示机构，开发者需要将id记录下来以管理该商品audit_id用于定位审核数据 | |
示例
正常返回
{
"err_msg": "success",
"err_no": 0,
"log_id": "2021122721141201022513314212345678",
"data": {
"object_id": "I6543216888019123456",
"audit_id": "QUA202202090019433632123456"
}
}异常返回
{
"err_msg": "资质文件大小超过限制",
"err_no": 10001,
"log_id": "2021122721141201022513314212345678"
}枚举参数
object_type--资质主体类型
资质类型 | 资质编码 |
|---|---|
老师 | 1 |
机构 | 2 |
qualification_info -> type--资质主体类型
资质主体类型 | 资质主体编码 |
|---|---|
机构营业许可证 | 1 |
教师资格证 | 2 |
专业性学历证书 | 3 |
专业认证 | 4 |
