Als ik de BAG REST API documentatie op de PDOK website bekijk, ontbreekt er volgens mij een (vrij essentieel) stukje.
Het gaat bijvoorbeeld bij ‘Geografisch zoeken op één of meer instanties van een pand’ om deze tekst:
De lengte- en breedtegraad in WGS84, EPSG:4326. Deze is nagenoeg gelijk aan ETRS89 EPSG:4258 en kan als standaard lengte- en breedtegraden worden gebruikt.
Als ik de link naar het YAML-document kopieer en deze open in de Swagger-editor, zie ik deze tekst wel terug.
Meer in het algemeen vind ik de documentatie zoals die in de standaard Swagger UI wordt weergegeven overzichtelijker dan die op de PDOK-website. Als je bijvoorbeeld meer wilt weten over dieperliggende key-value pairs in het request body schema bij filteren op geometrie, moet je op het groter dan (>) of punt (.) teken klikken (rood omlijnd in de schermafdruk). Dat was mij niet meteen duidelijk.