返品事由区分情報取得

リクエストURL

ホスト

https://api.next-engine.org

エンドポイント

/api_v1_system_returnedreason/info

リファレンス内容

情報取得について

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

情報取得と検索APIの違いは、以下の通りです

情報取得は、対象データを全て取得します（検索条件などの指定が不可能）
情報取得は、全フィールドを取得します（取得対象フィールドの指定が不可能）

入力パラメータ

パラメータ	値	省略	備考
`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以外とする)	詳細はパラメータ共通事項「待機フラグについて」を参照して下さい

出力パラメータ

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

返品事由区分

項目名	フィールド名	データ型	備考
返品事由区分	`returned_reason_id`	文字列型
返品事由名	`returned_reason_name`	文字列型

サンプル

リクエスト

curl -X POST -H "Content-Type: application/x-www-form-urlencoded" \ -d 'access_token=xxxxxxxxxxxxxx&refresh_token=xxxxxxxxxxxxxx&wait_flag=1' \
"https://api.next-engine.org/api_v1_system_returnedreason/info"

レスポンス

{
  "result": "success",
  "count": "8",
  "data": [
    {
      "returned_reason_id": "0",
      "returned_reason_name": "受注キャンセル"
    },
    {
      "returned_reason_id": "10",
      "returned_reason_name": "商品不良"
    },
    {
      "returned_reason_id": "20",
      "returned_reason_name": "受取拒否"
    },
    {
      "returned_reason_id": "30",
      "returned_reason_name": "長期不在"
    },
    {
      "returned_reason_id": "40",
      "returned_reason_name": "クレーム"
    },
    {
      "returned_reason_id": "50",
      "returned_reason_name": "誤配"
    },
    {
      "returned_reason_id": "60",
      "returned_reason_name": "出荷遅延"
    },
    {
      "returned_reason_id": "70",
      "returned_reason_name": "住所不明"
    }
  ],
  "access_token": "xxxxxxxxxxx",
  "access_token_end_date": "2017-04-13 18:24:53",
  "refresh_token": "xxxxxxxxxxx",
  "refresh_token_end_date": "2017-04-15 18:24:53"
}

エラー

エラーコード

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