FAQ:アプリ環境

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

はい、ネクストエンジンアプリの連携にはSSL認証された（httpsではじまる）URLでアクセス可能なサーバーが必要です。
クライアントID、クライアントシークレットとはなんですか？

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

アプリごとに異なる値が割り振られ、ネクストエンジンがアプリの識別に利用します。
認証情報のため第3者へ漏らさないよう取扱にはご注意ください。
ネクストエンジンAPIはバッチ（コマンドライン）での利用は可能ですか？

はい、実現は可能です。

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

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

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

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

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

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

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

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