API リファレンス / 商品

画像の並び替え

リクエスト例

curl -X PUT "https://apiv2.thebase.com/api/items/123/images" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
  "image_ids": [
    0
  ]
}'

パラメータ

リクエストボディ application/json

• image_idsinteger[]必須
  画像 ID を表示順に並べた配列（1〜20 件）。先頭が 1 番目です。その商品に現存するすべての画像を過不足なく一度ずつ含める必要があります。全置換のため、部分指定はできません。ID の重複は指定できません。

レスポンス

200 のレスポンスボディ（application/json）:

• imagesItemImage[]必須
  商品画像の一覧（最大 20 件）。表示順に並びます。
  • idinteger必須≥ 0
    画像 ID
  • urlstring (uri)必須
    画像の公開 URL。アップロードされたままのサイズで返します。
  • scaled_urlstring (uri)必須
    縦横比を保ったまま幅を変えた画像の URL。幅 640px を指定した例です。URL に含まれる幅の値を変えると、任意の幅で取得できます。
  • square_urlstring (uri)必須
    中央を切り抜いて正方形にした画像の URL。一辺 900px を指定した例です。URL に含まれる寸法の値を変えると、任意の大きさで取得できます。

エラー

エラーは application/problem+json の Problem 形式で返します。 認証・スコープ・予期しない内部エラーなど、すべてのエンドポイントに共通のエラーと 構造・判別方法は エラーレスポンス を参照してください。

このエンドポイントが返すその他のエラーは次のとおりです。