don-apis git:20260117.9697a65A

Immutable. This exact content never changes and is served at /api/v1/blob/2a6c50ab75de787b.

---
name: don-apis
description: Dutch Government API design rules, OpenAPI specifications, and API architecture guidelines. Use when building REST APIs for Dutch government projects, creating OpenAPI specs, or implementing API design patterns like webhooks and event-driven architecture.
metadata:
  source: developer.overheid.nl
  synced-from: https://github.com/developer-overheid-nl/don-site
  topic: apis
---

# DON APIs

## When to Use This Skill

Use this skill when you need guidance on:
- API
- REST
- OpenAPI
- OAS
- webhooks

## How to Navigate

This skill contains documentation organized by topic. Browse the references below or ask about specific topics.

## References

- [index](references/index.md)

### Aan De Slag

- [Bouw een API](references/aan-de-slag/bouw-een-api.md)
- [index](references/aan-de-slag/index.md)
- [maak-een-oas](references/aan-de-slag/maak-een-oas.md)

### Api Design Rules

- [api-design-rules-linter](references/api-design-rules/api-design-rules-linter.md)
- [api-design-rules-validator](references/api-design-rules/api-design-rules-validator.md)
- [cheat-sheet](references/api-design-rules/cheat-sheet.md)
- [doc-openapi-contact](references/api-design-rules/hoe-te-voldoen/doc-openapi-contact.md)
- [doc-openapi](references/api-design-rules/hoe-te-voldoen/doc-openapi.md)
- [http-methods](references/api-design-rules/hoe-te-voldoen/http-methods.md)
- [index](references/api-design-rules/hoe-te-voldoen/index.md)
- [no-trailing-slash](references/api-design-rules/hoe-te-voldoen/no-trailing-slash.md)
- [publish-openapi](references/api-design-rules/hoe-te-voldoen/publish-openapi.md)
- [semver](references/api-design-rules/hoe-te-voldoen/semver.md)
- [uri-version](references/api-design-rules/hoe-te-voldoen/uri-version.md)
- [version-header](references/api-design-rules/hoe-te-voldoen/version-header.md)
- [index](references/api-design-rules/index.md)

### Architectuur

- [cloudevents](references/architectuur/cloudevents.md)
- [eda](references/architectuur/eda.md)
- [index](references/architectuur/index.md)
- [webhooks](references/architectuur/webhooks.md)

### Gedrag En Implementatie

- [gelijktijdigheid-met-optimistic-locking](references/gedrag-en-implementatie/gelijktijdigheid-met-optimistic-locking.md)
- [API Gedrag en Implementatie](references/gedrag-en-implementatie/index.md)
- [problem-details](references/gedrag-en-implementatie/problem-details.md)
- [retries-met-volledige-idempotency](references/gedrag-en-implementatie/retries-met-volledige-idempotency.md)

### Openapi Specification

- [index](references/openapi-specification/index.md)
- [openapi-specification-generator](references/openapi-specification/openapi-specification-generator.md)

### Tools

- [index](references/tools/index.md)
- [wuppiefuzz](references/tools/wuppiefuzz.md)


---

Source: https://github.com/developer-overheid-nl/don-site/tree/main/docs/apis