ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2021-03-02. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてください。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してください。

OpenAPI の記述

GitHub Enterprise Server の REST API は、OpenAPI 3.0 準拠のドキュメントで詳細に記述されています。

ここには以下の内容があります:

OpenAPI の記述について

OpenAPI は、REST API を記述するための標準仕様です。 OpenAPI の記述は、人間にとっても機械にとっても判読しやすくなっており、 あらかじめドキュメントを読んだり実装を理解したりする必要がありません。 GitHub は、REST API を OpenAPI 3.0 準拠のドキュメントとして公開しています。

GitHub OpenAPI の記述を取得する

OpenAPI の記述は、オープンソースの REST API OpenAPI Description リポジトリにあります。

OpenAPI の記述には 2 つの形式があります。 バンドルバージョンは、再利用と判読に適した OpenAPI コンポーネントを含んでいるため、たいていの場合に有効です。 完全逆参照バージョンは、ツール環境でコンポーネントへのインライン参照がサポートされていない場合のために用意されています。

GitHub OpenAPI 記述を使用する

OpenAPI の記述にはいろいろな使い方があります。 たとえば、次のような方法を使用します。

  • 独自の API クライアントを生成する。
  • GitHub REST API の記述を検証してテストする。
  • Insomnia や Postman といったサードパーティツールを使用して、GitHub Enterprise Server REST API を調べ、操作する。

たとえば、GitHub は REST OpenAPI の記述を使用して GitHub Enterprise Server REST API リファレンスドキュメントを生成します。