# API定義を作成
/api-definitionsエンドポイントでPOSTメソッドを使って、API定義をTalend Cloud API Designerにインポートします。
## 始める前に
個人用のアクセストークンが生成されていること。詳細は、[パーソナルアクセストークンを生成](https://help.qlik.com/talend/r/ja-JP/Cloud/management-console-user-guide/cloud-access-token)をご覧ください。
## 手順
1. Talend Cloud API Testerを開き、新しいリクエストを作成します。
2. [METHOD] (メソッド)ドロップダウンリストからPOSTを選択します。
3. 正しいリージョンパラメーターと共に次のURIを入力します。
https://apid.{region}.cloud.talend.com/api/v1/api-definitions
リージョンは以下のいずれかとなります。
* us-west
* us
* eu
* ap
* au
詳細は、[Talend CloudのリージョンとURL](https://help.qlik.com/talend/r/ja-JP/Cloud/links-regions-urls)をご覧ください。
4. オプション: [QUERY PARAMETERS] (クエリーパラメーター)を展開して[Add query parameters] (クエリーパラメーターを追加)をクリックします。
次のパラメーターを使用できます。
| パラメーター | 説明 |
| --- | --- |
| format | インポートしているAPI定義の形式です。値は次のようになります。
- OpenApi3 (デフォルト値)
- Swagger20
- Swagger12
- Raml10
- Raml08
|
| failOnWarnings | モデル変換時の最初の警告で処理を停止するかどうかを指定します。値としてtrueかfalseを指定します。デフォルト値はfalseです。 |
| mainFile | 複数のファイルが含まれているAPI定義をZIPファイルでインポートしている場合は、メインの定義ファイル名を入力します。 |
5. [Add hearder] (ヘッダーを追加)ボタンをクリックし、[name] (名前)フィールドに Authorizationと、そして[value] (値)フィールドにBearerに続けてスペースと自分のトークンを入力します。
情報メモヒント: Talend Cloud API Testerでは、自分のトークンをプライベート環境変数として追加し、式ビルダーを使ってリクエストで参照できます。詳細は、[環境の使用](https://help.qlik.com/talend/r/ja-JP/Cloud/api-tester-user-guide/using-environments)をご覧ください。
6. オプション: Content-Typeヘッダーを編集します。
Talend Cloud API Testerはデフォルトで、application/jsonという値を持つContent-TypeヘッダーをPOSTリクエストに追加します。定義をYAMLファイルかZIPファイルとしてインポートする場合は、この値をapplication/x-yamlまたはapplication/zipに変更します。
7. API定義を追加します。
* [BODY] (ボディ)テキストボックスに定義を入力します。 ![\[Body\] (ボディ)テキストボックスにAPI定義が含まれている状態。](https://help.qlik.com/talend/ja-JP/api-user-guide/Resources/images/create_api_definition_1_enter_definition.png)
* リクエスト本文の上にある[text] (テキスト)ドロップダウンリストをクリックして[File] (ファイル)を選択した後、ファイルを参照するかドラッグ＆ドロップします。 ![\[File\] (ファイル)が選択され、このエリアにファイルをドラッグ＆ドロップするよう求めるメッセージが表示されている状態。](https://help.qlik.com/talend/ja-JP/api-user-guide/Resources/images/create_api_definition_2_import_file.png)
8. リクエストが設定されたら、[Send] (送信)をクリックします。
## タスクの結果
API定義がTalend Cloud API Designerに作成されます。返されたレスポンスにはそのIDとその他のメタデータ(作成者IDや作成日など)が含まれています。 