Als gemeente wil ik altijd absolute URL's in de response terugkrijgen

[CathyDingemanse]

...zodat ik 1 implementatie op de API Gateway voor de handling van deze URL's kan maken.

Aanleiding: melding gemeente Rotterdam:

Response en requests kunnen referenties bevatten met en zonder de protocol://hostname:port/base_context Tevens kan de tunnel worden aangeroepen vanuit extern of intern. Dit levert een andere baseurl op.

BAG Een request op de opentunnel BAG haalcentraal https://opentunnel.ta-twd.rotterdam.nl/opentunnel/haalcentraal/bag/adressen?zoekresultaatIdentificatie=adr-067d5d681558acc0bfb461233a3655a5 opentunnel geeft deze door naar de BAG https://api.bag.acceptatie.kadaster.nl/esd/huidigebevragingen/v1/adressen?zoekresultaatIdentificatie=adr-067d5d681558acc0bfb461233a3655a5 in de response van de BAG komen referenties terug als https://api.bag.acceptatie.kadaster.nl/esd/huidigebevragingen/v1/panden/0622100000048640 Deze moeten worden omgezet naar de URL waar de request in opentunnel op binnenkwam https://opentunnel.ta-twd.rotterdam.nl/opentunnel/haalcentraal/bag/panden/0622100000048640 We gebruiken dus het protocol en de host om deze weer om te zetten.

BRK Een request op de opentunnel BRK haalcentraal https://opentunnel.tawd.rotterdam.nl/opentunnel/haalcentraal/bkr/kadastraalonroerendezaken/76870487970000/zakelijkgerechtigden/30493367 Dit gaat naar de BAG als https://api.brk.kadaster.nl/esd-eto/bevragen/v1/kadastraalonroerendezaken/76870487970000/zakelijkgerechtigden/30493367 in de response komen de referenties als relatieve paden terug, dus zonder protocol, host baseurl /kadastraalonroerendezaken/76870487970000/zakelijkgerechtigden/30493367 Vanuit kadaster kunnen tevens referenties terugkomen waar wel de baseurl in staat wanneer het bijvoorbeeld gaat om BAG objecten https://api.bag.kadaster.nl/esd/huidigebevragingen/v1/adressen/adressen/{adressen.nummeraanduidingIdentificatie}   VRAAG De vraag is nu hoe om te gaan met deze varianten van referenties. Blijkbaar heeft de BRK ervoor gekozen om op basis van relatieve paden te werken waar de BAG gebruik maakt van absolute paden. We kunnen voor BAG alle links vertalen naar de opentunnel links Voor BRK kunnen we net als bij BAG de absolute paden vertalen naar opentunnel links en de relatieve paden voorzien van het opentunnel baseurl

OPLOSSING

o Maak alle paden absoluut, en vertaal deze tussen opentunnel URL en Externe URL HAALCENTRAAL Response en requests kunnen referenties bevatten met en zonder de protocol://hostname:port/base_context Tevens kan de tunnel worden aangeroepen vanuit extern of intern. Dit levert een andere baseurl op.

BAG Een request op de opentunnel BAG haalcentraal https://opentunnel.ta-twd.rotterdam.nl/opentunnel/haalcentraal/bag/adressen?zoekresultaatIdentificatie=adr-067d5d681558acc0bfb461233a3655a5 opentunnel geeft deze door naar de BAG https://api.bag.acceptatie.kadaster.nl/esd/huidigebevragingen/v1/adressen?zoekresultaatIdentificatie=adr-067d5d681558acc0bfb461233a3655a5 in de response van de BAG komen referenties terug als https://api.bag.acceptatie.kadaster.nl/esd/huidigebevragingen/v1/panden/0622100000048640 Deze moeten worden omgezet naar de URL waar de request in opentunnel op binnenkwam https://opentunnel.ta-twd.rotterdam.nl/opentunnel/haalcentraal/bag/panden/0622100000048640 We gebruiken dus het protocol en de host om deze weer om te zetten.

BRK Een request op de opentunnel BRK haalcentraal https://opentunnel.ta-twd.rotterdam.nl/opentunnel/haalcentraal/bkr/kadastraalonroerendezaken/76870487970000/zakelijkgerechtigden/30493367 Dit gaat naar de BAG als https://api.brk.kadaster.nl/esd-eto/bevragen/v1/kadastraalonroerendezaken/76870487970000/zakelijkgerechtigden/30493367 in de response komen de referenties als relatieve paden terug, dus zonder protocol, host baseurl /kadastraalonroerendezaken/76870487970000/zakelijkgerechtigden/30493367 Vanuit kadaster kunnen tevens referenties terugkomen waar wel de baseurl in staat wanneer het bijvoorbeeld gaat om BAG objecten https://api.bag.kadaster.nl/esd/huidigebevragingen/v1/adressen/adressen/{adressen.nummeraanduidingIdentificatie}   VRAAG De vraag is nu hoe om te gaan met deze varianten van referenties. Blijkbaar heeft de BRK ervoor gekozen om op basis van relatieve paden te werken waar de BAG gebruik maakt van absolute paden. We kunnen voor BAG alle links vertalen naar de opentunnel links Voor BRK kunnen we net als bij BAG de absolute paden vertalen naar opentunnel links en de relatieve paden voorzien van het opentunnel baseurl OPLOSSING

o Maak alle paden absoluut, en vertaal deze tussen opentunnel URL en Externe URL

Acceptatiecriteria

• [ ]
• [ ]

Definition of done

• [ ] functionele specificatie
• [ ] Open API specificatie
• [ ] gegenereerde code
• [ ] testgevallen
• [ ] referentie-implementatie