API-register: Overzicht

API to access the API register of developer.overheid.nl.

This API distinguishes between public and private endpoints. Public endpoints can be accessed with either an API key or a client credentials token. Private endpoints can only be accessed with a client credentials token.

Using an API key, you can access all public endpoints of the API register. These requests can also be made from the browser. Request a read-only API key at https://apis.developer.overheid.nl/apis/key-aanvragen. Simply pass the obtained API key with each request using the X-Api-Key header.

Using a client credentials token, you can access both public and private endpoints of the API register. To obtain the token, you need to perform a POST request to https://auth.developer.overheid.nl/realms/don/protocol/openid-connect/token with the following Form URL Encoded body:

• grant_type: client_credentials
• scope: depending on the access you need and the client you are, you can request one or more of the following scopes:
  • apis:read
  • apis:write
  • organisations:read
  • organisations:write
• client_id: the client id you received from us
• client_secret: the client secret you received from us

Pass the obtained token with each request using the Authorization header. Example:

Authorization: Bearer {ACCESS_TOKEN} (replace {ACCESS_TOKEN} with the obtained access_token)

Pagination of collections is done using the Link header. There are various libraries available (such as parse-link-header for Javascript) that can parse this header. Additionally, the following headers provide extra support for implementing pagination in the client:

• Current-Page: the current page in the collection
• Per-Page: the number of items per page
• Total-Count: the total number of items
• Total-Pages: the total number of pages

API to access the API register of developer.overheid.nl.

This API distinguishes between public and private endpoints. Public endpoints can be accessed with either an API key or a client credentials token. Private endpoints can only be accessed with a client credentials token.

Using an API key, you can access all public endpoints of the API register. These requests can also be made from the browser. Request a read-only API key at https://apis.developer.overheid.nl/apis/key-aanvragen. Simply pass the obtained API key with each request using the X-Api-Key header.

Using a client credentials token, you can access both public and private endpoints of the API register. To obtain the token, you need to perform a POST request to https://auth.developer.overheid.nl/realms/don/protocol/openid-connect/token with the following Form URL Encoded body:

• grant_type: client_credentials
• scope: depending on the access you need and the client you are, you can request one or more of the following scopes:
  • apis:read
  • apis:write
  • organisations:read
  • organisations:write
• client_id: the client id you received from us
• client_secret: the client secret you received from us

Pass the obtained token with each request using the Authorization header. Example:

Authorization: Bearer {ACCESS_TOKEN} (replace {ACCESS_TOKEN} with the obtained access_token)

Pagination of collections is done using the Link header. There are various libraries available (such as parse-link-header for Javascript) that can parse this header. Additionally, the following headers provide extra support for implementing pagination in the client:

• Current-Page: the current page in the collection
• Per-Page: the number of items per page
• Total-Count: the total number of items
• Total-Pages: the total number of pages

Een API om een autorisatiecomponent (AC) te benaderen.

De AUTORISATIE is het kernobject in deze API. Autorisaties worden toegekend aan applicaties. Een applicatie is een representatie van een (web) app die communiceert met de API van (andere) componenten, zoals het ZRC, DRC, ZTC en BRC.

Deze API laat toe om autorisaties van een (taak)applicatie te beheren en uit te lezen.

Afhankelijkheden

Deze API is afhankelijk van:

• Notificaties API

Autorisatie

Deze API vereist autorisatie. Je kan de token-tool gebruiken om JWT-tokens te genereren.

Deze API publiceert notificaties op het kanaal autorisaties.

Main resource

applicatie

Kenmerken

Resources en acties

• applicatie: create, update, destroy

Handige links

• Documentatie
• Zaakgericht werken

De Basisregistratie adressen en gebouwen (BAG) bevat gegevens over panden, verblijfsobjecten, standplaatsen en ligplaatsen en de bijbehorende adressen (openbare ruimte, nummeraanduiding en woonplaats).

De BAG terugmeldingenservice bevat recente meldingen op informatie uit de Basisregistratie Adressen en Gebouwen (BAG) waarover twijfel bestaat. De service toont de locatie, inhoud en status van de meldingen. Ook een vermoedelijke fout geconstateerd? Doe een melding op https://bagviewer.kadaster.nl

De gegevens bestaan uit BAG-panden inclusief panden met de status 'gesloopt' en een deel van BAG-gegevens van deze panden met de zich daarin bevindende verblijfsobjecten en adresinformatie. Ook de ligplaatsen en standplaatsen zijn opgenomen. Lees meer over de BAG. Bekijk de vector tiles in de Vectortile Viewer.

De gegevens bestaan uit BAG-panden inclusief panden met de status 'gesloopt' en een deel van BAG-gegevens van deze panden met de zich daarin bevindende verblijfsobjecten en adresinformatie. Ook de ligplaatsen en standplaatsen zijn in de Vector Tiles opgenomen. Lees meer over de BAG en bekijk de BAG vector tiles in de Vectortile Viewer.

De gegevens bestaan uit BAG-panden inclusief panden met de status 'gesloopt' en een deelselectie van BAG-gegevens van deze panden en de zich daarin bevindende verblijfsobjecten. Ook de ligplaatsen en standplaatsen zijn hierin opgenomen met een deelselectie van BAG-gegevens. Lees meer over de BAG en bekijk de BAG vector tiles in de Vectortile Viewer.

BRP - Gewaspercelen bestaat uit de locatie van landbouwpercelen met daaraan gekoppeld het geteelde gewas. Het bestand is een selectie van informatie uit de Basisregistratie Percelen (BRP) van de Rijksdienst voor Ondernemend Nederland. De omgrenzingen van de landbouwpercelen zijn gebaseerd op het Agrarisch Areaal Nederland (AAN). De gebruiker van het perceel dient jaarlijks zijn gewaspercelen in te tekenen en aan te geven welk gewas wordt geteeld op het betreffende perceel. Van elk jaar wordt een dataset gegenereerd van peildatum 15 mei. Van de meest recente BRP gewaspercelen is een viewservices en een downloadservice beschikbaar.

De Basisregistratie Grootschalige Topografie (BGT) is de gedetailleerde grootschalige basiskaart (digitaal) van Nederland, waarin de ligging van alle fysieke objecten zoals gebouwen, wegen, water, spoorlijnen en (landbouw)terreinen is geregistreerd. Lees meer over de BGT en bekijk de BGT vector tiles in de Vectortile Viewer.