【泛知识】添加资质
接口介绍
该接口用于添加老师/机构的资质,调用成功过后,接口返回资质的唯一表示 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时必填) | 机构资质审核信息 |
|
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 |