图片 API
Image API v4 提供图片api功能。
调用验证
详情参见 REST API 概述的 鉴权方式 说明。
OPPO图片上传
调用地址
POST v4/image/oppo
POST v4/image/oppo
此代码块在浮窗中显示
请求示例
请求头
> POST /v4/image/oppo HTTP/1.1
> Authorization: Basic Yzk2ZjQyZTBkMmU2NjJlNDVkMDM1YWIxOmRmNGQ1OWU4NGVhYzJmOWQ1M2IzNmYxMg==
> POST /v4/image/oppo HTTP/1.1
> Authorization: Basic Yzk2ZjQyZTBkMmU2NjJlNDVkMDM1YWIxOmRmNGQ1OWU4NGVhYzJmOWQ1M2IzNmYxMg==
此代码块在浮窗中显示
请求体
{
"big_picture_url" : "",
"small_picture_url": ""
}
{
"big_picture_url" : "",
"small_picture_url": ""
}
此代码块在浮窗中显示
请求参数
| 关键字 | 类型 | 选项 | 含义 |
|---|---|---|---|
| big_picture_url | String | 可选 | |
| small_picture_url | String | 可选 |
返回参数说明
| 关键字 | 类型 | 选项 | 含义 |
|---|---|---|---|
| big_picture_id | String | 可选 | 大图片id |
| small_picture_id | String | 可选 | 小图标id |
返回示例
成功返回
< HTTP/1.1 200 OK
< Content-Type: application/json
{
"big_picture_id": "",
"small_picture_id": ""
}
< HTTP/1.1 200 OK
< Content-Type: application/json
{
"big_picture_id": "",
"small_picture_id": ""
}
此代码块在浮窗中显示
失败返回
{
"error": {
"code": 21003,
"message": "Parameter value is invalid"
}
}
{
"error": {
"code": 21003,
"message": "Parameter value is invalid"
}
}
此代码块在浮窗中显示
调用返回
HTTP 状态码
参考文档：HTTP-Status-Code
错误码
| Code | 描述 | 详细解释 | HTTP Status Code |
|---|---|---|---|
| 0 | success | 成功 | 200 |
| 21001 | The method is not supported or url err | 请求方法(GET/POST)错误或者 url 错误(接口不存在) | 404 |
| 21003 | Parameter value is invalid | 参数值不合法 | 400 |
| 23001 | Basic authentication failed | HTTP Basic authorization 失败 | 401 |
| 23002 | Missing parameter! | 缺少了必须的参数 | 400 |
| 23100 | server error | 系统内部错误 | 500 |
| 27000 | Server response time out, please try again later | 系统内部错误 | 500 |
| 51 | Picture Size Exceeds | OPPO返回的错误信息，一般是图片超过限制大小，建议更换图片 | 200 |
