画像 API | AppPush 開発者ガイド REST API 日本語

画像 API

最新更新：12日前

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	オプション	大画像の URL OPPO の要件：サイズ 984×369 px、ファイルサイズ 1MB 以内、フォーマットは PNG/JPG/JPEG
small_picture_url	String	オプション	小アイコンの URL OPPO の要件：サイズ 144×144 px、ファイルサイズ 50KB 以内、フォーマットは PNG/JPG/JPEG

戻りパラメータ

キーワード	タイプ	オプション	意味
big_picture_id	String	オプション	大画像 ID
small_picture_id	String	オプション	小アイコン ID

戻り例

成功

HTTP/1.1 200 OK Content-Type: application/json

              
              HTTP/1.1 200 OK
Content-Type: application/json

このコードブロックはフローティングウィンドウ内に表示されます

{ "big_picture_id": "*******", "small_picture_id": "example_small_picture_id" }

              
              {
    "big_picture_id": "*******",
    "small_picture_id": "example_small_picture_id"
}

このコードブロックはフローティングウィンドウ内に表示されます

例の ID はレスポンス構造を示すためのものです。アップロード API が返す実際の ID を使用してください。ID が空の場合、空文字列ではなくキー自体が省略されます。

失敗

{ "error": { "code": 21003, "message": "Parameter value is invalid" } }

              
              {
  "error": {
    "code": 21003,
    "message": "Parameter value is invalid"
  }
}

このコードブロックはフローティングウィンドウ内に表示されます

呼び出し戻り

HTTP ステータスコード

参照: HTTP-Status-Code

エラーコード

コード	説明	詳細説明	HTTP ステータスコード
0	success	成功	200
21001	Only support http POST request	HTTP POST リクエストのみをサポートします	405
21003	Parameter value is invalid	パラメータ値が不正	400
23001	Basic authentication failed	HTTP Basic 認証失敗	401
23002	Missing parameter!	必須パラメータが不足	400
23100	server error	システム内部エラー	400
27000	Server response time out, please try again later	システム内部エラー	500
51	Picture Size Exceeds	OPPO のエラー。画像サイズ超過が原因のことが多いため、画像を変更してください	200