# OpenAPI Specification (OAS)

:::info[Verplichte standaard]

Deze standaard is
[verplicht voor REST API's](https://www.forumstandaardisatie.nl/open-standaarden/openapi-specification)
van de overheid. Let op: momenteel wordt alleen OAS versie 3.0.x goedgekeurd.

:::

Met OAS kunnen alle endpoints, responses en requests van een API gedetailleerd
beschreven worden in het machine-leesbare `YAML` of `JSON` formaat. De
[OAS Generator](../../tools/openapi-specification-generator.md) genereert op basis van
minimale configuratie een kant-en-klare OAS template die voldoet aan de
[REST API Design Rules](../api-design-rules).

OAS wordt beheerd door het [OpenAPI Initiative](https://www.openapis.org/). De
volledige documentatie over de specificatie is te vinden op:
[OpenAPI Spec 3.0](https://spec.openapis.org/oas/v3.0.3).