图片上传接口
收藏我的收藏
收藏发起进件请求需要上传商户证件等图片，需要先调用图片上传接口获取 image_id。
使用限制
无
接口说明
- 1.请求参数必须使用 form 表单格式。
基本信息
基本信息 | |
HTTP URL | |
HTTP Method | POST |
接口频次 | 20QPS(小程序app_id维度或者thirdparty_id纬度) |
请求头
名称 | 类型 | 必填 | 描述 |
Content-Type | string | 是 | 固定值 "multipart/form-data" |
请求参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
app_id | string | 条件选填 | 64 | 小程序的 app_id 在开发者身份下必填 | ttdb96ad2b44aeff3301 |
access_token | string | 条件选填 | 64 | 小程序token 在开发者身份下必填 获取链接 | 567234784 |
thirdparty_id | string | 条件选填 | 64 | 小程序第三方平台应用 id 在服务商身份下必填 | ttc4a8b2155b82682f |
component_access_token | string | 条件选填 | 64 | 服务商绑定的token 在服务商身份下必填 获取链接 | "8431201934ab" |
image_type | string | 是 | 64 | 图片格式，支持格式：jpg、jpeg、png | jpg |
image_content | byte_array | 是 | 2097152 | 图片二进制字节流，最大为2M | |
请求示例
key | value |
app_id | ttdb96ad2b44aeff3301 |
access_token | 567234784 |
image_type | jpg |
image_content | 010101 |
响应参数
公共响应 参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
error_no | number | 是 | - | 返回码，详见错误码及错误描述 | 2008 |
error_tips | string | 是 | - | 返回码描述，详见错误码及错误描述 | 签名校验异常，请使用正确的签名和 json 传参 |
业务响应参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
image_id | string | 是 | 256 | 图片在文件存储平台的标识 | 6523.jpeg |
响应示例
正常响应示例
{ "err_no": 0, "err_tips": "", "image_id": "6523.jpeg" }
异常异常示例
{ "err_no": 2008, "err_tips": "签名校验异常，请使用正确的签名和 json 传参", "image_id": "" }
错误码
错误码 err_no | 描述 err_tips | 排查建议 |
0 | "" | 上传成功 |
2008 | 签名校验异常，请使用正确的签名和 json 传参 | 请检查app_id和access_token或者thirdparty_id和component_access_token的正确性 |
7004 | 超过单个图片允许的限制(2M) | 请适当压缩图片大小以免超过上传限制 |
7005 | 图片文件为空 | 商户更换文件后，重新调用 |
7006 | 未知图片类型 | 图片类型必须为JPG, PNG，JPEG |
