FAQ一覧

FAQ:アクセストークン

質問 回答
アプリを開いたら 「このウェブページにはリダイレクト ループが含まれています」と表示されます。

アクセストークンが切れている場合があるため、
まずは、お客様がログインされているか確認してください。


ネクストエンジンAPIはバッチ(コマンドライン)での利用は可能ですか?

はい、実現は可能です。

ただし、Webアプリケーションを想定した仕組みのため、いくつか工夫が必要です。

【前提】
・APIの利用には「アクセストークン」が必要
・アクセストークンを更新するには「リフレッシュトークン」が必要
・アクセストークンは24h、リフレッシュトークンは72hの有効期限がある
・有効期限が切れた場合はAPIの呼び出しに失敗する。ただし、リフレッシュトークンが有効期限内で
 あればアクセストークンの更新(トークンの再発行と有効期限の延長)が可能

APIリファレンスに詳細な情報がございますので合わせてご確認ください

【対応方法】
「アクセストークン」の取得には以下の2つのパターンがあります
 1)ネクストエンジンIDとパスワードでの認証
 2)リフレッシュトークンを利用したアクセストークンの更新

1.少なくとも初回は必ず1)の対応が必要なため、弊社から提供しておりますSDKなどをご利用いただき、
  1)の方法でアクセストークンとリフレッシュトークンを取得していただく。
  (アプリの「Redirect URI」にはlocalhostなど、お使いの環境から見えるURLを設定してください)

2.取得したアクセストークンとリフレッシュトークンを利用しAPIを呼び出す
3.有効期限が切れた場合は2)の方法でアクセストークンを更新していただく
4.2に戻る

1)の方法はブラウザとWebサーバーなど弊社サーバーから値を渡すための環境が必要ですが、
2)の方法はバッチなどのプログラムが動かせる環境があれば実現可能かと思います。

【注意点】
・リフレッシュトークンの有効期限が切れた場合は1)の方法でアクセストークンを再取得する必要があります。
 そのため前回起動から72h以内には2)の方法でアクセストークンの再取得が必要です
・プラットフォームの画面から1)に利用したネクストエンジンIDのユーザーのアプリの利用権限を変更した場合、
 アクセストークンが更新されるためAPIが呼び出せなくなります
・アクセストークンはネクストエンジンIDごとに値が異なるため、どなたかユーザーと紐づくことになりますので
 API経由で更新したメイン機能の履歴がそのユーザーのものになる場合がございます


FAQ:アプリ環境

質問 回答
アプリケーションの動作環境にはSSL認証されたサーバーが必要でしょうか。

はい、ネクストエンジンアプリの連携にはSSL認証された(httpsではじまる)URLでアクセス可能なサーバーが必要です。


クライアントID、クライアントシークレットとはなんですか?

ネクストエンジンAPIのアプリごとに発行されるIDとパスワードのようなものです。

アプリごとに異なる値が割り振られ、ネクストエンジンがアプリの識別に利用します。
認証情報のため第3者へ漏らさないよう取扱にはご注意ください。


ネクストエンジンAPIはバッチ(コマンドライン)での利用は可能ですか?

はい、実現は可能です。

ただし、Webアプリケーションを想定した仕組みのため、いくつか工夫が必要です。

【前提】
・APIの利用には「アクセストークン」が必要
・アクセストークンを更新するには「リフレッシュトークン」が必要
・アクセストークンは24h、リフレッシュトークンは72hの有効期限がある
・有効期限が切れた場合はAPIの呼び出しに失敗する。ただし、リフレッシュトークンが有効期限内で
 あればアクセストークンの更新(トークンの再発行と有効期限の延長)が可能

APIリファレンスに詳細な情報がございますので合わせてご確認ください

【対応方法】
「アクセストークン」の取得には以下の2つのパターンがあります
 1)ネクストエンジンIDとパスワードでの認証
 2)リフレッシュトークンを利用したアクセストークンの更新

1.少なくとも初回は必ず1)の対応が必要なため、弊社から提供しておりますSDKなどをご利用いただき、
  1)の方法でアクセストークンとリフレッシュトークンを取得していただく。
  (アプリの「Redirect URI」にはlocalhostなど、お使いの環境から見えるURLを設定してください)

2.取得したアクセストークンとリフレッシュトークンを利用しAPIを呼び出す
3.有効期限が切れた場合は2)の方法でアクセストークンを更新していただく
4.2に戻る

1)の方法はブラウザとWebサーバーなど弊社サーバーから値を渡すための環境が必要ですが、
2)の方法はバッチなどのプログラムが動かせる環境があれば実現可能かと思います。

【注意点】
・リフレッシュトークンの有効期限が切れた場合は1)の方法でアクセストークンを再取得する必要があります。
 そのため前回起動から72h以内には2)の方法でアクセストークンの再取得が必要です
・プラットフォームの画面から1)に利用したネクストエンジンIDのユーザーのアプリの利用権限を変更した場合、
 アクセストークンが更新されるためAPIが呼び出せなくなります
・アクセストークンはネクストエンジンIDごとに値が異なるため、どなたかユーザーと紐づくことになりますので
 API経由で更新したメイン機能の履歴がそのユーザーのものになる場合がございます


FAQ:アプリ公開

質問 回答
本番環境用のクライアントID、クライアントシークレットはいつから利用可能になりますか?

アプリの販売開始後にご利用可能です。

ご利用不可の状態だと、クライアントIDとクライアントシークレットが
赤字に、利用可能な上代だと黒字になっていますのでご注意ください。


アプリの審査期間はどのくらいですか?

ネクストエンジンマニュアル「アプリを販売するには」をご参照ください。


APIの利用には料金がかかりますか?

テスト環境でのAPI利用には料金が発生せず無料で利用可能です。

本番環境での利用の場合、アプリの種別によってAPIの利用量に応じて料金がかかります。
詳細は以下のマニュアルをご参照ください。

ネクストエンジンマニュアル「ご利用料金について」


FAQ:エラー

質問 回答
ネクストエンジンがメンテナンス中にAPIにリクエストを送るとエラーが返ってきますか?

はい、エラーが返ってきます。

・メンテナンス中に
ネクストエンジンAPIへリクエストされた場合、
メッセージコード
「003005」または「003004」が返ってきます。

参照


エラーが発生した場合アクセストークンとリフレッシュトークンは返ってきますか?

返ってくる場合と来ない場合があります。

resultがerrorの場合でも, 基本的には有効なaccess_token, refresh_tokenを返します.

ただし, リクエストされたaccess_token, refresh_tokenが不正の場合(エラーコード: 002002, 002004),
一部のシステムエラー(エラーコード: 999999)の場合は有効なaccess_token, refresh_tokenを返しません

メッセージ一覧


FAQ:商品

質問 回答
商品ページ(β版)のAPI対応の予定はありますか?

商品ページ(β版)が正式版となりましたら、APIについても対応する予定です。
現時点でβ版終了日は未定となっております。


FAQ:受注

質問 回答
APIで受注明細を更新し、更新したデータをAPIで取得しようとした場合、即時更新した内容がAPIで取得できますか?

即時反映したものが取得できます。

※但し、非同期で更新される機能があります。(2つ)

・受注一括登録
・商品マスタ予約一括登録