API利用方法
1. はじめに
本ドキュメントではFujitsu Research Portalで公開しているAPIの利用方法について説明します。
Fujitsu Research Portalで公開しているAPIを利用するためには、アカウント作成後、作成したアカウントにログインする必要があります。アカウント作成方法については、アカウント作成方法を参照してください。なお、マニュアルで利用しているスクリーンショットなどは最新のポータル画面と異なる場合がありますのでご了承ください。
通常のAPIとアプリ開発用APIの2種類が用意されている場合、次のような違いがあります。通常のAPIは、APIアクセストークンによりAPIを利用可能ですが、APIアクセストークンには有効期限があるため、APIを試用する用途に適しています。ユーザ固有のパラメータはAPIアクセストークンから読み出されます。一方、アプリ開発用APIは、固定のサブスクリプションキーによりAPIを利用可能なため、APIを利用してアプリを開発する用途に適しています。ユーザ固有のパラメータは、アプリ側で制御してAPIへのリクエストパラメータに含める必要があります。
2. 利用方法
本ドキュメントではFujitsu Research Portalで公開しているAPIの利用方法を2種類説明します。
また、APIアクセストークンを用いて、Fujitsu Research Portal上のAPIを利用する場合、ユーザごとに5 request / min という利用回数の制限があります。ユーザごとにカウントするため、異なるAPIを利用した場合もカウントされます。
2.1. Fujitsu Research Portal上でのAPIの利用
-
Fujitsu Research Portalへのログイン後、利用したい技術を選択し、「技術のお試しはこちら」から「詳細」ページに移ります。
-
「詳細」ページ下部の「技術を試す」ボタンをクリックします。「技術を試す」ボタンは、未ログインの場合、またはログイン済みであるが技術個別規約に同意していない場合に表示されます。
-
ポップアップに、SMSに届いた「確認コード」をフォームに入力し、「コードの確認」ボタンをクリックします。
-
「利用規約への同意について」の内容を確認し、同意いただける場合は「利用規約に同意する」のチェックボックスにチェックを入れて「次に進む」ボタンをクリックします。同意いただけない場合は、上部の「キャンセル」をクリックして画面を閉じてください。
-
「詳細」ページに「APIを試す」ボタンが表示されますので、クリックします。「APIを試す」ボタンは、ログイン済みかつ技術個別規約に同意した場合に表示されます。
-
API一覧より利用したいAPIを選択します。利用したいAPIのヘッダやパラメータ、ボディを確認し、右上の「Try it」ボタンをクリックして「Try it」ページを表示します。
-
「Try it」ページの「Authorization」タブを開き、「Developer_Portal_Access_Token」の項目で「authorization_code」を選択します。選択すると、「Headers」タブに自動で「Authorization」項目と認証して得られるAPIアクセストークンが付与されます。
-
「Parameters」や「Headers」、「Body」の各項目に必要な情報を入力し、「Try it」ページの下部の「HTTP request」タブの「Send」ボタンをクリックします。「HTTP request」タブ下のプルダウンメニューから言語を選択することでその言語でのAPIリクエストを行うためのコードが表示されます。
-
実行結果が表示されることを確認してください。
2.2. cURLなどからのAPI利用方法
-
Fujitsu Research Portal上でのAPIの利用の手順8と同様の操作をし、必要な情報を入力します。次に、「HTTP request」タブ下のプルダウンメニューから「Curl」を選択し、「Copy」をクリックしてcURLコマンドをコピーします。
-
cURLが利用できる環境のターミナルなどを起動し、コピーしたcURLコマンドをペーストして実行します。この際、ターミナルによっては「Request body」に改行を含む場合、改行部分でコマンドが区切られてしまうことがあるため、その場合は改行を削除してから実行してください。
-
実行結果が表示されるので確認してください。
2.3. API仕様書のダウンロード
「API仕様」ページ中央の「API definition」から形式を選択することで、指定の形式のAPI仕様書をダウンロードできます。
