圖片 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 |
