APIのバージョンに関する一般的な情報を編集し、メディアの種類、エンドポイント、セキュリティスキームを定義します。
手順
-
一般情報ページにアクセスします。
このページは、APIの作成後に自動的に開きます。左パネルの上部のAPIの名前をクリックして開くこともできます。
-
[GENERAL] (一般)セクションの左側にある鉛筆アイコンをクリックし、APIのバージョン、説明、連絡先とライセンス情報、利用規約を編集します。
-
[MEDIA TYPES] (メディアタイプ)セクションを編集して、メディアタイプを追加または削除します。
このセクションで定義されているメディアタイプはグローバルで、APIバージョン全体に適用されます。これらは、オペレーションレベルで定義することもできます。
-
エンドポイントを[ENDPOINTS] (エンドポイント)セクションに追加します。
このセクションで定義されているエンドポイントはグローバルで、APIバージョン全体に適用されます。これらが定義されると、エンドポイントは、有効な場合は、左パネルの上部のAPIの名前の下、モックエンドポイントに表示されます。
公開済みエンドポイントはライブドキュメンテーションおよびポータルに表示されます。Talend Cloud API TesterでAPIを試す時にも、最初の公開済みエンドポイントが使用されます。詳細は、Talend Cloud API TesterでのAPIの試行をご覧ください。公開されていないエンドポイントはTalend Cloud API Designerにのみ表示されます。
注: 複数のエンドポイントがある場合、Talend Cloud API TesterでAPIを試した時に、リストの最初のものがデフォルトで使用されます。リストのエンドポイントを移動するには、URLの左側のバーをクリックし、上下にドラッグします。 -
[GLOBAL SECURITY] (グローバルセキュリティ)および[SECURITY SCHEMES] (セキュリティスキーム)セクションで、APIのセキュリティを定義します。
このセクションで定義されているセキュリティはグローバルで、APIバージョン全体に適用されます。これは、リソースレベルおよびオペレーションレベルで定義することもできます。
- [Save] (保存)をクリックします。