BRK API: onjuiste resultaten bij geografisch zoeken op percelen

Bij de volgende API call op de BRK API (https://www.pdok.nl/restful-api/-/article/basisregistratie-kadaster-brk-#) krijg ik een grote lijst van resultaten:

curl -X PUT
https://brk.basisregistraties.overheid.nl/api/v1/perceel
-H ‘Postman-Token: d530d3ec-0693-4c88-ac08-4c8b134aa4e0’
-H ‘cache-control: no-cache’
-d ‘{“geometry”: {“contains”:{“point”: [4.3132, 52.6231]}}}’

De percelen in de response komen niet overeen met mijn zoekopdracht. Zit er een fout in mijn call? Ik wil graag één perceel zien per puntlocatie die ik opgeef.

Dit is waarschijnlijk een missende Content-Type header. Die moet je bij het meegeven van een bodyparameter op application/json zetten.

Met deze header ( -H ‘Content-Type: application/json’ )
krijg ik de volgende foutmelding:
{
“title”: “Bad Request”,
“status”: 400,
“detail”: “Request parameters didn’t validate.”,
“invalidParams”: [
{
“name”: “validation.request.body.schema.additionalProperties”,
“reason”: “[Path ‘/geometry/contains’] Object instance has properties which are not allowed by the schema: [“point”]”
},
{
“name”: “validation.request.body.schema.required”,
“reason”: “[Path ‘/geometry/contains’] Object has missing required properties ([“coordinates”,“type”])”
}
]
}

Kan het kloppen dat er een fout zit in de bodyparameter syntax in de documentatie?

We zijn in ieder geval een stap verder, want de bodyparameter wordt nu herkend.

Dit is een voorbeeld van een correcte body:

{
  "geometry": {
    "intersects": {
      "type": "Point",
      "coordinates": [5.142147102036006, 52.06609824188417]
    }
  }
}

Als je jouw body (zonder type en coordinates) uit de documentatie hebt, moeten we daar eens naar kijken. Want dat klopt absoluut niet.

1 like

Dankjewel voor je hulp, deze oplossing werkt.

De content-type header had ik over het hoofd gezien in de documentatie. De body had ik hier vandaan:
https://www.pdok.nl/restful-api/-/article/basisregistratie-kadaster-brk-#/paths/~1perceel/get

Kleine extra opmerking …

Voor documentatie met betrekking tot de REST API van de BRK zou ik hier kijken:
https://brk.basisregistraties.overheid.nl/restful-api?articleid=1930301#/paths/~1percelen~1_zoek/post

Die documentatie wordt gegenereerd op basis van de OpenAPI spec van de API die nu live staat. De documentatie op pdok.nl is duidelijk gedateerd.

1 like

De documentatie op PDOK.nl is nu aangepast :wink:

2 likes