上传材料
开发环境
开发环境
POST
/auth/entity/upload_material
接口说明
该接口用于上传资质材料。在审核资质之前需要先使用该接口上传资质。如果需要大批量上传资质材料，请保证上传 QPS 不大于 10。
上传资源后会立即得到一个 uri，该 uri 是作为上传资质接口中材料的 path 参数。
创建沙盒环境小程序时请选择“正式小程序能力映射”，详情请关注行业角色系统能力文档。
注意事项
- access_token获取的方式 获取access_token
| 基本 | |
|---|---|
| HTTP URL | 正式环境：https://developer.toutiao.com/auth/entity/upload_material 沙盒环境：https://open-sandbox.douyin.com/auth/entity/upload_material |
| HTTP Method | POST |
| 权限要求 | AccessToken鉴权 |
material_type 的取值：
| 资源类型 | 资源类型编码 | 文件限制大小 | 文件格式要求 | 备注 |
|---|---|---|---|---|
| 身份证照片 | 1000 | <= 20MB | jpeg、jpg、png | |
| 老师教师资格证 | 1001 | <= 20MB | jpeg、jpg、png | |
| 教师专业性学历-专业性学历 | 1002 | <= 20MB | jpeg、jpg、png | |
| 教师专业性证书-专业认证 | 1003 | <= 20MB | jpeg、jpg、png | |
| 教师特殊课程类目认证 | 1004 | <= 20MB | jpeg、jpg、png | |
| 机构和老师之间的合作声明 | 1005 | <= 20MB | jpeg、jpg、png | 【开放平台】泛知识老师vs机构合作声明 |
| 授权函(在泛知识行业是服务商和老师的授权书) | 1006 | <= 20MB | jpeg、jpg、png | (代运营服务商和老师的授权函) 【开放平台】泛知识机构/老师《原创声明/授权声明》模板 |
| 机构营业执照照片 | 1007 | <= 5MB | jpeg、jpg、png | |
| 机构logo照片 | 1008 | <= 5MB | jpeg、jpg、png | |
| 机构注册证图片 | 1009 | <= 5MB | jpeg、jpg、png | |
| 服务商合作案例 | 1010 | <=5MB | 请提供过往与客户合作的成功案例或合作协议，需包含客户名称、解决方案、成果等信息 | |
| 机构特殊课程类目认证 | 1011 | <= 5MB | jpeg、jpg、png | |
| 老师在小程序的头像icon | 1012 | <=5MB | jpeg、jpg、png |
错误码
请求参数
Body 参数multipart/form-data
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/auth/entity/upload_material' \
--header 'Authorization: Bearer <token>' \
--form 'appid="ttyyyyy"' \
--form 'access_token="08xxxxxxx5238673d3d"' \
--form 'material_type="1000"' \
--form 'material_file="/Users/bytedance/Desktop/xxx.jpg"'响应示例响应示例
{
"err_no": 0,
"err_tips": "",
"path": "certification/resource/c60cbb3b8bb043cc9b349bf5484e1980"
} 修改于 2025-11-11 10:42:23