search

VNG-Realisatie / Haal-Centraal-BRK-bevragen

Project repository tbv de ontwikkeling van de Haal Centraal BRK Bevragen API
https://vng-realisatie.github.io/Haal-Centraal-BRK-bevragen/
Other
19 stars 15 forks source link

Importeren API definitie #182

Open idr2019 opened 5 years ago

idr2019 commented 5 years ago

Wij proberen de API definitie van BRK Bevragen API te importeren in Postman. Dit lukt echter niet.

Postman genereert de volgende foutmelding wanneer we de URL die in Swagger gepubliceerd is proberen te importeren (https://raw.githubusercontent.com/VNG-Realisatie/BRK-Bevragingen/master/specificatie/openapi.yaml): Error while importing Open API 3.0: Could not import

Wanneer we de yaml bestand welke aangetroffen is op GitHub (Centraal-BRK-bevragen/specificatie/sprint7 ) proberen te importeren wordt de volgende foutmelding gegenereerd:

'format not recognized'.

Bevatten de API definities fouten of doen wij iets fout?

JohanBoer commented 5 years ago

Jullie doen niets fout en de API-definities bevatten geen fouten. Postman kan niet omgaan met referenties naar externe (yaml-)bestanden die wij in de yaml opgenomen hebben. Deze referenties zijn primair vanuit beheer-oogpunt interessant dus daar mogen jullie geen last van hebben. Ik heb nu een "resolved" versie van de API opgenomen in de map "resolved" waarmee ik ale externe verwijzingen opgelost heb en opgenomen heb in de openapi.yaml zelf. Die heb ik getest en deze importeert wel in Postman.

Wij zullen vanaf nu de resloved versie van de yaml publiceren.