# ドキュメントに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 リファレンス** Space の目次に。

<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>Space の目次に API リファレンスを挿入します。</p></figcaption></figure>

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

エンドポイントページを生成したい Space で、 **新規追加...** ボタンを Space の下部にある [目次](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 仕様を選んでから、 **挿入** をクリックして、エンドポイントを自動的に Space に追加します。必要に応じて、すべての 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 ブロックを追加する**

ブロックセレクターを開くには **/**&#x3092;押して、OpenAPI を検索します。
{% endstep %}

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

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

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

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