OpenAPI（OpenAPI specification）について

OpenAPI（OpenAPI specification（仕様））について解説しています。OpenAPI（OpenAPI specification（仕様））は、「OAS」とも呼ばれる。

OpenAPI（OpenAPI specification（仕様））は、以前は Swagger（Swagger specification（仕様））として知られており、RESTful Web サービスの記述、生成及び視覚化に使用できる形式で、REST APIの仕様規格であり、構造と構文を定義している。REST APIの仕様規格であるため、プログラミング言語にとらわれないのが特徴でもある。また、人間と機械（コンピュータ）の両方が読み取れる。

ちなみにOpenAPIは誰でも自由に使え、比較的少ない制限で利用できるが、公開者、もしくは開発者が、APIデータの利用方法を制限することがあるので注意する必要がある。

なお、OpenAPI（OpenAPI specification（仕様））を使えば、APIがどのように動作するかをすぐに発見することができる。API仕様は通常、YAMLかJSONで記述されている。