开发
API

【泛知识】修改资质

接口介绍

该接口用于修改已通过添加资质接口获取 object_id 的老师或机构的资质。

成功调用接口后,所修改的目标资质进审,审核通过后,新资质生效;在新资质生效前,之前资质的状态仍然有效(对于已过审资质)。

若连续调用修改资质接口,则会取消之前进审记录,重新进审。

接入接口须知泛知识小程序课程管理规范

审核结果将通过通知回调接口通知开发者。

使用限制

接口说明

前提条件

  • 所修改的资质必须为已上传且未进行审核或已过审资质,对于初次上传且未过审的资质,需要调用添加资质接口重新获取 object_id
  • 资源 uri 字段的来源于是上传课程资源的返回,需要先调用资源上传接口,收到上传成功回调消息,或者调用资源上传查询接口确认状态为上传成功后才有效,否则会报"无效的 uri"错误

注意事项

  • 若未做额外备注,string 类型的默认字段默认支持字符集 utf-8
  • 对于修改接口,有以下常见的几种场景

常见场景:

资质类型

场景

接口行为

机构

机构资质已送审,且尚未得到审核结果

调用修改接口会撤回之前审核,重新进审

机构

机构资质已送审,且已审核通过

调用修改接口则进行常规修改审核的流程

机构

机构资质已送审,且审核未通过

该资质为初次进审,此时不能调用修改接口,此时,旧object_id失效,需要调用添加接口重新获取 object_id

老师

当前行业分级未进审过(未在获取 object_id 时进审)

注:老师的行业资质由 object_id 与行业分级唯一确定

调用修改接口,为此老师创建一个新的行业的资质,进审该行业分级,视作添加新资质

老师

当前行业分级已进审,且尚未得到审核结果

调用修改接口会撤回之前审核,重新进审

老师

当前行业分级已进审,且已审核通过

调用修改接口则进行常规修改审核的流程

老师

当前行业分级已进审,审核不通过且为初次进审

此时,之前objecgt_id失效,不能调用修改接口,需要调用添加接口重新获取 object_id

请求

基本信息

HTTP URL

https://developer-product.zijieapi.com/product/api/modify_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": 2, 
        "object_id":"I3453623455343",
        "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": "张三",
            "introduction":"该老师..." 
        }
    }
}

参数说明

qualification--资质信息

参数名

参数类型

是否必须

描述

示例

object_type

enum

资质类型选择:1-老师,2-机构,参见本章节最后枚举说明部分

1

object_id

string

资质ID,由添加接口获取

"T3253426234322"

teacher_qualification_info

object

(当object_type=1时必填)

老师资质审核信息

{
    "teacher_qualification_info": {
        "name": "张三", 
        "first_class": 10000, 
        "second_class": 10010, 
        "third_class": 0, 
        "ID_img_uris": [
            "product/resource/002b47258345646892b517009a473630"
        ], 
        "ID_number": "630874561823280017", 
        "qualification_info_lst": [
            {
                "type": 2, 
                "image_uris": [
                    "product/resource/002b47258345646892b517009a473630"
                ], 
                "validity_date": "", 
                "license_id": ""
            }
        ],
        "img_uri": "tos-boe-i-3rjuffv3j3/710081825fd1dfc9c428fd5e877b0e5e",
        "nickname": "张三",
        "introduction":"该老师..." 
    }
 }

institution_qualification_info

object

(当object_type=2时必填)

机构资质审核信息

{
"institution_qualification_info": {
    "name": "北京******科技有限公司",
    "institution_introduction": "****是专注抖音知识付费、内容变现、课程上传、支持短视频直播挂载的小程序",
    "company_name": "北京******科技有限公司",
    "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": "张三"
}

}

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

[
    "product/resource/qualification1.jpg", 
    "product/resource/qualification2.jpg"
]

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

资质信息列表

[
    "qualification_info": {
        {
            "type": 1,
            "image_uris": ["product/resource/002b47258345646892b517009a473630"],
            "validity_date": "2022-09-21",
            "license_id": "2352WE600099"
        }
    }
   ...
]

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(string)

机构法人身份证图片uri列表,需要调用上传后获得,要求必须上传正反面身份证图片,数量为2

[
    "product/resource/qualification1.jpg", 
    "product/resource/qualification2.jpg"
]

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": {
        {
            "type": 1,
            "image_uris": ["product/resource/002b47258345646892b517009a473630"],
            "validity_date": "2022-09-21",
            "license_id": "2352WE600099"
        }
    }
   ...
]

qualification_info--资质详情

填写具体的资质信息,包括资质图片、资质有效期等。若主体类型为机构,则必须填写 licenseId。

参数名

参数类型

是否必须

描述

示例

type

enum

资质相关类型,有如下类型:1:机构营业许可证2:教师资格证3:专业性学历证书4:专业认证其中,当资质主体类型为机构时选择1,为老师时,2、3、4中至少填一个

1

image_uris

array(string)

资质图片uri列表,uri需要调用上传后获得,可以上传多张图片,图片总大小不可超过100MB

[
    "product/resource/qualification1.jpg", 
    "product/resource/qualification2.jpg"
]

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,
    "object_id": "T32412342351",
    "institution_qualification_info": {
      "name": "北京******科技有限公司",
      "institution_introduction": "****是专注抖音知识付费、内容变现、课程上传、支持短视频直播挂载的小程序",
      "company_name": "北京******科技有限公司",
      "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用于定位审核数据

{ 
		"object_id": "T219839732423423234", 
    "audit_id": "QUA202202090019433632267267"
}

示例

正常返回

{
  "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

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助