# 商品画像 — ネクストエンジン API

> 商品画像 カテゴリの API endpoint (2 件) を集約したファイル。
> インデックス: https://developer.next-engine.com/llms.txt | 全文: https://developer.next-engine.com/llms-full.txt

---

# 商品画像件数取得
URL: https://developer.next-engine.com/api/api_v1_master_goodsimage/count/
Method: POST
API Endpoint: https://api.next-engine.org/api_v1_master_goodsimage/count
Tag: 商品画像
Required parameters: access_token
Optional parameters: refresh_token, wait_flag, fields, offset, limit

## リクエストURL

ホスト

`https://api.next-engine.org`

エンドポイント

`/api_v1_master_goodsimage/count`

## リファレンス内容


### 件数取得について

入力パラメータはPOST、出力パラメータはレスポンス(レスポンスボディにJSON)になります

検索条件を複数指定した場合、全ての条件がかつ(AND)となります

### 入力パラメータ

| パラメータ | 値 | 省略 | 備考 |
| --- | --- | --- | --- |
| `access_token` | access_token取得により取得した値 | 必須(SDKの場合不要) | |
| `refresh_token` | access_token取得により取得した値 | 可能(SDKの場合不要) | 【指定してaccess_tokenの有効期限が切れた場合】 正常に出力パラメータが設定されaccess_tokenとrefresh_tokenが新しい値に更新されます 【省略してaccess_tokenの有効期限が切れた場合】 出力パラメータ「result」の値がredirectになります（成功時以外の出力パラメータ参照) |
| `wait_flag` | 1:メイン機能過負荷でも可能な限りエラーにせず実行1以外:メイン機能過負荷の場合、003002のエラーを返却 | 可能(省略時は1以外とする) | 詳細はパラメータ共通事項「待機フラグについて」を参照して下さい |
| フィールド名-比較演算子(WHERE句のカラムと比較演算子相当) | 検索条件の値(WHERE句の値相当) | 可能 | 例：商品マスタ検索でパラメータ：goods_id-like、値："%-red"と指定した場合、商品コードが*-redの商品マスタを検索します |

### 出力パラメータ

| パラメータ名 | 値 | 備考 |
| --- | --- | --- |
| `result` | `success` | success以外の場合の出力パラメータは成功時以外の出力パラメータ参照 |
| `access_token` | 入力パラメータで指定したaccess_token／新たに発行されたaccess_token | 有効なrefresh_tokenを指定してaccess_tokenの有効期限がきれた場合、新たに発行(この時点から1日有効)されたaccess_tokenになります |
| `access_token_end_date` | access_tokenの有効期限切れ日時 | |
| `refresh_token` | 入力パラメータで指定したrefresh_token／新たに発行されたrefresh_token | access_tokenが新しく発行された場合、新たに発行(この時点から3日有効)されたrefresh_tokenになります |
| `refresh_token_end_date` | refresh_tokenの有効期限切れ日時 | |
| `count` | 検索結果の件数 | |


### 商品画像

| 項目名 | フィールド名 | データ型 | 備考 |
| --- | --- | --- | --- |
| 商品画像ID | `goods_image_id` | 数値型 | |
| 商品コード | `goods_image_goods_id` | 文字列型 | |
| ファイル名 | `goods_image_file_name` | 文字列型 | |
| 画像URL(HTTP) | `goods_image_url_http` | 文字列型 | |
| 画像URL(HTTPS) | `goods_image_url_https` | 文字列型 | |
| サイズ | `goods_image_size` | 数値型 | 単位はバイト。500KB(1024計算)以下 |
| 幅 | `goods_image_width` | 数値型 | 単位：ピクセル。2100px以下 |
| 高さ | `goods_image_height` | 数値型 | 単位：ピクセル。2100px以下 |
| 画像説明 | `goods_image_alt` | 文字列型 | HTMLのimg要素のalt属性 |
| 自動変換フラグ | `goods_image_convert_flg` | 数値型 | 自動作成したJPEG画像がある場合、1。このフラグが1の場合、URLはjpg以外が設定されており、拡張子をjpgにしてアクセスすることでjpgファイルにもアクセス出来ます |
| 並び順 | `goods_image_display_order` | 文字列型 | |
| ファイル状態 | `goods_image_status` | 数値型 | 0:未ダウンロード 1:ダウンロード中 2:ダウンロード済み 3:アップロード済み 4:アップロード中 9:削除済み ※ファイル選択でアップロードされた場合は、1になります |
| 削除フラグ | `goods_image_deleted_flag` | 文字列型 | |
| 作成日 | `goods_image_creation_date` | 日時型 | |
| 最終更新日 | `goods_image_last_modified_date` | 日時型 | |
| 最終更新日 | `goods_image_last_modified_null_safe_date` | 日時型 | NULLの場合作成日 |
| 作成担当者ID | `goods_image_creator_id` | 数値型 | |
| 作成担当者名 | `goods_image_creator_name` | 文字列型 | |
| 最終更新者ID | `goods_image_last_modified_by_id` | 数値型 | |
| 最終更新者ID | `goods_image_last_modified_by_null_safe_id` | 数値型 | NULLの場合作成者ID |
| 最終更新者名 | `goods_image_last_modified_by_name` | 文字列型 | |
| 最終更新者名 | `goods_image_last_modified_by_null_safe_name` | 文字列型 | NULLの場合作成者名 |


 サンプル
### サンプル

リクエスト

```bash
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d 'access_token=xxxxx&refresh_token=xxxxx' https://api.next-engine.org/api_v1_master_goodsimage/count
```

レスポンス

```json
{
  "result": "success",
  "count": "1",
  "access_token": "xxxxx",
  "access_token_end_date": "2017-04-18 11:19:26",
  "refresh_token": "xxxxx",
  "refresh_token_end_date": "2017-04-20 11:19:26"
}
```


## エラー

### エラーコード

エンドポイント固有のエラーコードはありません。
共通エラーコードは [メッセージコード一覧](/guides/param/message/) を参照してください。

## 関連リンク

- 構造化スキーマビュー: [`/openapi/operations/api_v1_master_goodsimage_count/`](/openapi/operations/api_v1_master_goodsimage_count/) (OpenAPI 3.1 のインタラクティブ仕様)
- エラーコード一覧: [`/guides/param/message/`](/guides/param/message/) (`result`/`code`/`message` の意味)

### 同じカテゴリの他のエンドポイント (商品画像)

- [商品画像検索](/api/api_v1_master_goodsimage/search/) — `POST /api_v1_master_goodsimage/search`

---

# 商品画像検索
URL: https://developer.next-engine.com/api/api_v1_master_goodsimage/search/
Method: POST
API Endpoint: https://api.next-engine.org/api_v1_master_goodsimage/search
Tag: 商品画像
Required parameters: access_token
Optional parameters: refresh_token, wait_flag, fields, offset, limit

## リクエストURL

ホスト

`https://api.next-engine.org`

エンドポイント

`/api_v1_master_goodsimage/search`

## リファレンス内容


### 検索について

入力パラメータはPOST、出力パラメータはレスポンス(レスポンスボディにJSON)になります

検索条件を複数指定した場合、全ての条件がかつ(AND)となります

### 入力パラメータ

| パラメータ | 値 | 省略 | 備考 |
| --- | --- | --- | --- |
| `access_token` | access_token取得により取得した値 | 必須(SDKの場合不要) | |
| `refresh_token` | access_token取得により取得した値 | 可能(SDKの場合不要) | 【指定してaccess_tokenの有効期限が切れた場合】 正常に出力パラメータが設定されaccess_tokenとrefresh_tokenが新しい値に更新されます 【省略してaccess_tokenの有効期限が切れた場合】 出力パラメータ「result」の値がredirectになります（成功時以外の出力パラメータ参照) |
| `wait_flag` | 1:メイン機能過負荷でも可能な限りエラーにせず実行1以外:メイン機能過負荷の場合、003002のエラーを返却 | 可能(省略時は1以外とする) | 詳細はパラメータ共通事項「待機フラグについて」を参照して下さい |
| `fields` | 検索結果で取得するフィールドをカンマ区切りで指定(SELECT句相当) | 必須 | 例：商品マスタ検索で「goods_id, goods_name, stock_quantity, supplier_name」を指定した場合、「商品コード、商品名、在庫数、仕入先名」を検索結果として取得します |
| フィールド名-比較演算子(WHERE句のカラムと比較演算子相当) | 検索条件の値(WHERE句の値相当) | 可能 | 例：商品マスタ検索でパラメータ：goods_id-like、値："%-red"と指定した場合、商品コードが*-redの商品マスタを検索します |
| `offset` | オフセットの数値(OFFSET句相当) | 可能(省略時0) | 0：一番最初の検索結果から取得、1:２番めの検索結果から取得・・・ |
| `limit` | 取得数の数値(LIMIT句相当) | 可能(省略時10000) | |

### 出力パラメータ

| パラメータ名 | 値 | 備考 |
| --- | --- | --- |
| `result` | `success` | success以外の場合の出力パラメータは成功時以外の出力パラメータ参照 |
| `access_token` | 入力パラメータで指定したaccess_token／新たに発行されたaccess_token | 有効なrefresh_tokenを指定してaccess_tokenの有効期限がきれた場合、新たに発行(この時点から1日有効)されたaccess_tokenになります |
| `access_token_end_date` | access_tokenの有効期限切れ日時 | |
| `refresh_token` | 入力パラメータで指定したrefresh_token／新たに発行されたrefresh_token | access_tokenが新しく発行された場合、新たに発行(この時点から3日有効)されたrefresh_tokenになります |
| `refresh_token_end_date` | refresh_tokenの有効期限切れ日時 | |
| `count` | 検索結果の件数 | |
| `data` | 検索結果の連想配列(JSONのオブジェクト型) | |

### 検索速度について

入力パラメータのfieldsの指定を増やすほど処理に時間が掛かります。必要な情報のみ検索した方がより高速になります

検索結果のデータ量が増える程、指数関数的に検索結果の取得に時間がかかります(アプリのWebサーバーの性能が低い程顕著です)。Webサーバーの見直し又は、limit又はfieldsを調整して下さい

大量の検索結果を取得する場合、アクセスが集中する07:00～22:00の時間帯を避けてバックグラウンドで情報を取得することを推奨します


### 商品画像

| 項目名 | フィールド名 | データ型 | 備考 |
| --- | --- | --- | --- |
| 商品画像ID | `goods_image_id` | 数値型 | |
| 商品コード | `goods_image_goods_id` | 文字列型 | |
| ファイル名 | `goods_image_file_name` | 文字列型 | |
| 画像URL(HTTP) | `goods_image_url_http` | 文字列型 | |
| 画像URL(HTTPS) | `goods_image_url_https` | 文字列型 | |
| サイズ | `goods_image_size` | 数値型 | 単位はバイト。500KB(1024計算)以下 |
| 幅 | `goods_image_width` | 数値型 | 単位：ピクセル。2100px以下 |
| 高さ | `goods_image_height` | 数値型 | 単位：ピクセル。2100px以下 |
| 画像説明 | `goods_image_alt` | 文字列型 | HTMLのimg要素のalt属性 |
| 自動変換フラグ | `goods_image_convert_flg` | 数値型 | 自動作成したJPEG画像がある場合、1。このフラグが1の場合、URLはjpg以外が設定されており、拡張子をjpgにしてアクセスすることでjpgファイルにもアクセス出来ます |
| 並び順 | `goods_image_display_order` | 文字列型 | |
| ファイル状態 | `goods_image_status` | 数値型 | 0:未ダウンロード 1:ダウンロード中 2:ダウンロード済み 3:アップロード済み 4:アップロード中 9:削除済み ※ファイル選択でアップロードされた場合は、1になります |
| 削除フラグ | `goods_image_deleted_flag` | 文字列型 | |
| 作成日 | `goods_image_creation_date` | 日時型 | |
| 最終更新日 | `goods_image_last_modified_date` | 日時型 | |
| 最終更新日 | `goods_image_last_modified_null_safe_date` | 日時型 | NULLの場合作成日 |
| 作成担当者ID | `goods_image_creator_id` | 数値型 | |
| 作成担当者名 | `goods_image_creator_name` | 文字列型 | |
| 最終更新者ID | `goods_image_last_modified_by_id` | 数値型 | |
| 最終更新者ID | `goods_image_last_modified_by_null_safe_id` | 数値型 | NULLの場合作成者ID |
| 最終更新者名 | `goods_image_last_modified_by_name` | 文字列型 | |
| 最終更新者名 | `goods_image_last_modified_by_null_safe_name` | 文字列型 | NULLの場合作成者名 |


### 商品画像分類タグ

| 項目名 | フィールド名 | データ型 | 備考 |
| --- | --- | --- | --- |
| 商品画像分類タグID | `goods_image_tag_id` | 数値型 | |
| 商品画像ID | `goods_image_tag_goods_image_id` | 数値型 | |
| 画像分類タグID | `goods_image_tag_image_tag_id` | 文字列型 | |
| 削除フラグ | `goods_image_tag_deleted_flag` | 文字列型 | |
| 作成日 | `goods_image_tag_creation_date` | 日時型 | |
| 最終更新日 | `goods_image_tag_last_modified_date` | 日時型 | |
| 最終更新日 | `goods_image_tag_last_modified_null_safe_date` | 日時型 | NULLの場合作成日 |
| 作成担当者ID | `goods_image_tag_creator_id` | 数値型 | |
| 作成担当者名 | `goods_image_tag_creator_name` | 文字列型 | |
| 最終更新者ID | `goods_image_tag_last_modified_by_id` | 数値型 | |
| 最終更新者ID | `goods_image_tag_last_modified_by_null_safe_id` | 数値型 | NULLの場合作成者ID |
| 最終更新者名 | `goods_image_tag_last_modified_by_name` | 文字列型 | |
| 最終更新者名 | `goods_image_tag_last_modified_by_null_safe_name` | 文字列型 | NULLの場合作成者名 |


### 画像分類タグ

| 項目名 | フィールド名 | データ型 | 備考 |
| --- | --- | --- | --- |
| 画像分類タグID | `image_tag_id` | 数値型 | |
| モール/カートID | `image_tag_mall_id` | 数値型 | |
| モール/カートID(サブ) | `image_tag_mall_sub_id` | 数値型 | |
| 画像分類タグ | `image_tag_text` | 文字列型 | Ex:汎用-画像1,汎用-画像2,・・・ |
| 自動登録用タグ番号 | `image_tag_auto_register_no` | 数値型 | 通常は並び順と同じ。モール/カートID(サブ)がある場合のみ異なる値が設定される。汎用-画像1,2,BASE-画像1,2の場合BASE-画像1の並び順は1で自動登録用タグ番号は3。 |
| 並び順 | `image_tag_display_order` | 数値型 | |
| 削除フラグ | `image_tag_deleted_flag` | 文字列型 | |
| 作成日 | `image_tag_creation_date` | 日時型 | |
| 最終更新日 | `image_tag_last_modified_date` | 日時型 | |
| 最終更新日 | `image_tag_last_modified_null_safe_date` | 日時型 | NULLの場合作成日 |
| 作成担当者ID | `image_tag_creator_id` | 数値型 | |
| 作成担当者名 | `image_tag_creator_name` | 文字列型 | |
| 最終更新者ID | `image_tag_last_modified_by_id` | 数値型 | |
| 最終更新者ID | `image_tag_last_modified_by_null_safe_id` | 数値型 | NULLの場合作成者ID |
| 最終更新者名 | `image_tag_last_modified_by_name` | 文字列型 | |
| 最終更新者名 | `image_tag_last_modified_by_null_safe_name` | 文字列型 | NULLの場合作成者名 |


 サンプル
### サンプル

リクエスト

```bash
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d 'access_token=xxxxxxxxx&refresh_token=xxxxxxxxx&fields=xxxxxxxx,xxxxxxx&goods_image_creator_name-like=xxxxx&offset=0&limit=2' https://api.next-engine.org/api_v1_master_goodsimage/search
```

レスポンス

```json
{
  "result": "success",
  "count": "2",
  "data": [
    {
      "goods_image_id": "1",
      "goods_image_goods_id": "T101",
      "goods_image_file_name": "2af4aec82a6f7f67fa09b2ae5e84c87e_201701181.jpg",
      "goods_image_url_http": "xxxxx",
      "goods_image_url_https": "xxxxx",
      "goods_image_size": "219519",
      "goods_image_width": "2048",
      "goods_image_height": "1152",
      "goods_image_alt": "",
      "goods_image_convert_flg": "0",
      "goods_image_display_order": "1",
      "goods_image_status": "3",
      "goods_image_deleted_flag": "0",
      "goods_image_creation_date": "2017-01-18 15:44:50",
      "goods_image_last_modified_date": "2017-01-18 16:01:50",
      "goods_image_last_modified_null_safe_date": "2017-01-18 16:01:50",
      "goods_image_creator_id": "10004",
      "goods_image_creator_name": "xxxxx",
      "goods_image_last_modified_by_id": "10004",
      "goods_image_last_modified_by_null_safe_id": "10004",
      "goods_image_last_modified_by_name": "xxxxx",
      "goods_image_last_modified_by_null_safe_name": "xxxxx",
      "goods_image_tag_id": "1",
      "goods_image_tag_goods_image_id": "1",
      "goods_image_tag_image_tag_id": "1",
      "goods_image_tag_deleted_flag": "0",
      "goods_image_tag_creation_date": "2017-01-18 15:44:50",
      "goods_image_tag_last_modified_date": "2017-01-18 15:44:50",
      "goods_image_tag_last_modified_null_safe_date": "2017-01-18 15:44:50",
      "goods_image_tag_creator_id": "0",
      "goods_image_tag_creator_name": "System",
      "goods_image_tag_last_modified_by_id": "0",
      "goods_image_tag_last_modified_by_null_safe_id": "0",
      "goods_image_tag_last_modified_by_name": "System",
      "goods_image_tag_last_modified_by_null_safe_name": "System",
      "image_tag_id": "1",
      "image_tag_mall_id": "0",
      "image_tag_mall_sub_id": "0",
      "image_tag_text": "基本-画像1",
      "image_tag_auto_register_no": "1",
      "image_tag_display_order": "1",
      "image_tag_deleted_flag": "0",
      "image_tag_creation_date": "2014-10-17 17:08:45",
      "image_tag_last_modified_date": "2014-10-17 17:08:45",
      "image_tag_last_modified_null_safe_date": "2014-10-17 17:08:45",
      "image_tag_creator_id": "0",
      "image_tag_creator_name": "System",
      "image_tag_last_modified_by_id": "0",
      "image_tag_last_modified_by_null_safe_id": "0",
      "image_tag_last_modified_by_name": "System",
      "image_tag_last_modified_by_null_safe_name": "System"
    },
    {
      "goods_image_id": "2",
      "goods_image_goods_id": "T101",
      "goods_image_file_name": "e4213e243da9497baffb3e0db8a3f167_201702102.jpg",
      "goods_image_url_http": "xxxxx",
      "goods_image_url_https": "xxxxx",
      "goods_image_size": "130186",
      "goods_image_width": "800",
      "goods_image_height": "489",
      "goods_image_alt": "",
      "goods_image_convert_flg": "0",
      "goods_image_display_order": "2",
      "goods_image_status": "3",
      "goods_image_deleted_flag": "0",
      "goods_image_creation_date": "2017-02-10 16:08:41",
      "goods_image_last_modified_date": "2017-02-10 16:28:11",
      "goods_image_last_modified_null_safe_date": "2017-02-10 16:28:11",
      "goods_image_creator_id": "10002",
      "goods_image_creator_name": "xxxxx",
      "goods_image_last_modified_by_id": "10002",
      "goods_image_last_modified_by_null_safe_id": "10002",
      "goods_image_last_modified_by_name": "xxxxx",
      "goods_image_last_modified_by_null_safe_name": "xxxxx",
      "goods_image_tag_id": "2",
      "goods_image_tag_goods_image_id": "2",
      "goods_image_tag_image_tag_id": "2",
      "goods_image_tag_deleted_flag": "0",
      "goods_image_tag_creation_date": "2017-02-10 16:08:41",
      "goods_image_tag_last_modified_date": "2017-02-10 16:08:41",
      "goods_image_tag_last_modified_null_safe_date": "2017-02-10 16:08:41",
      "goods_image_tag_creator_id": "10002",
      "goods_image_tag_creator_name": "xxxxx",
      "goods_image_tag_last_modified_by_id": "10002",
      "goods_image_tag_last_modified_by_null_safe_id": "10002",
      "goods_image_tag_last_modified_by_name": "xxxxx",
      "goods_image_tag_last_modified_by_null_safe_name": "xxxxx",
      "image_tag_id": "2",
      "image_tag_mall_id": "0",
      "image_tag_mall_sub_id": "0",
      "image_tag_text": "基本-画像2",
      "image_tag_auto_register_no": "2",
      "image_tag_display_order": "2",
      "image_tag_deleted_flag": "0",
      "image_tag_creation_date": "2014-10-17 17:08:45",
      "image_tag_last_modified_date": "2014-10-17 17:08:45",
      "image_tag_last_modified_null_safe_date": "2014-10-17 17:08:45",
      "image_tag_creator_id": "0",
      "image_tag_creator_name": "System",
      "image_tag_last_modified_by_id": "0",
      "image_tag_last_modified_by_null_safe_id": "0",
      "image_tag_last_modified_by_name": "System",
      "image_tag_last_modified_by_null_safe_name": "System"
    }
  ],
  "access_token": "xxxxx",
  "access_token_end_date": "2017-04-18 11:19:26",
  "refresh_token": "xxxxx",
  "refresh_token_end_date": "2017-04-20 11:19:26"
}
```


## エラー

### エラーコード

エンドポイント固有のエラーコードはありません。
共通エラーコードは [メッセージコード一覧](/guides/param/message/) を参照してください。

## 関連リンク

- 構造化スキーマビュー: [`/openapi/operations/api_v1_master_goodsimage_search/`](/openapi/operations/api_v1_master_goodsimage_search/) (OpenAPI 3.1 のインタラクティブ仕様)
- エラーコード一覧: [`/guides/param/message/`](/guides/param/message/) (`result`/`code`/`message` の意味)

### 同じカテゴリの他のエンドポイント (商品画像)

- [商品画像件数取得](/api/api_v1_master_goodsimage/count/) — `POST /api_v1_master_goodsimage/count`