# ドキュメントにAPIリファレンスを挿入する

GitBook は、OpenAPI 仕様にあるエンドポイントに関連するページを自動的に生成できます。これらのページには OpenAPI の操作ブロックが含まれ、あなたや訪問者が仕様に基づいてエンドポイントをテストしたりさらに探索したりできます。

{% hint style="success" %}
仕様から追加されたエンドポイントは、仕様が更新されるたびに引き続き更新されます。詳細は [仕様を更新する](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/api-references/add-an-openapi-specification#update-your-specification) セクションを参照してください。
{% endhint %}

### 仕様から OpenAPI ページを自動作成する

〜した後、 [OpenAPI 仕様を追加](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/api-references/openapi/add-an-openapi-specification)すると、エンドポイントページを生成するために **OpenAPI リファレンス** をスペースの目次に挿入できます。

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FYy8gCqxfaO4xjv2eqiL5%2Fcreate_api_pages%402x.png?alt=media&#x26;token=62b8386b-9fea-4233-b961-b6a1e582411e" alt="A GitBook screenshot showing how to insert API references into the table of contents of a space"><figcaption><p>スペースの目次に API リファレンスを挿入します。</p></figcaption></figure>

{% stepper %}
{% step %}
**OpenAPI からページを生成する**

エンドポイントページを生成したいスペースで、 **新規追加...** ボタンをスペースの下部からクリックします。 [の目次](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/rissu/gitbook-ui#table-of-contents).

ここから、 **OpenAPI リファレンス**.
{% endstep %}

{% step %}
**OpenAPI 仕様を選択**

以前にアップロードした OpenAPI 仕様を選択し、 **挿入** をクリックしてエンドポイントをスペースに自動追加します。オプションで、すべての OpenAPI スキーマを参照するモデルページを追加することもできます。
{% endstep %}

{% step %}
**API 操作を管理する**

GitBook は、OpenAPI 仕様とその定義内で設定されたタグに基づいて自動的にページを生成します。

へ移動してください [structuring-your-api-reference](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/api-references/guides/structuring-your-api-reference "mention") OpenAPI 仕様を通じて操作を整理する方法について詳しくは、
{% endstep %}
{% endstepper %}

### 個別の OpenAPI ブロックを追加する

あるいは、仕様から個別に OpenAPI 操作やスキーマをドキュメント内のページに追加することもできます。

{% stepper %}
{% step %}
**新しい OpenAPI ブロックを追加**

を押してブロックセレクタを開き、 **/**&#x4F;penAPI を検索します。
{% endstep %}

{% step %}
**OpenAPI 仕様を選択**

以前にアップロードした OpenAPI 仕様を選択し、 **続行** して使用したいエンドポイントを選択します。
{% endstep %}

{% step %}
**挿入したい操作またはスキーマを選択する**

ドキュメントに挿入したい操作とスキーマを選び、クリックします **挿入**.
{% endstep %}
{% endstepper %}
