Open kad-hebbim opened 1 year ago
Ziet er goed uit, zoals besproken. Kunnen jullie e.e.a. ook aan de specificaties toevoegen, zodat gebruikers zich hierop kunnen voorbereiden?
Aangezien het nu wel een aardig omslachtige manier van werken is geworden wil ik toch nog een ander voorstel doen.
Ik vraag me namelijk af hoe deze endpoints nu precies gebruikt worden door de afnemers. Worden de links naar de zakelijkGerechtigden hier überhaupt wel gebruikt?
Kan me namelijk goed voorstellen dat ze toch altijd nog een aparte bevraging doen naar elke onroerendeZaak die ze terugkrijgen voor de persoon die ze bevragen om meer informatie over deze onroerendeZaak te krijgen. Daar krijgen ze dan ook al deze zakelijkGerechtigden terug. Dan zou de route dus worden (een tweetraps raket):
/kadasternietnatuurlijkpersonen/1
Per onroerendeZaak (of de onroerendeZaak die ze willen bevragen) de gegevens ophalen:
/kadastraalonroerendezaken/2
Per zakelijkGerechtigde (of de zakelijkGerechtigde die ze willen bevragen) de gegevens ophalen
/kadastraalonroerendezaken/2/zakelijkgerechtigden/3
of direct
/kadastraalonroerendezaken/2?expand=zakelijkgerechtigden
Aangezien het pijnpunt zit in het tonen van de links naar de individuele zakelijkgerechtigdeIdentificaties in deze resource, zouden we deze geheel kunnen verwijderen in de resource (is waarschijnlijk wel een breaking-change, maar wordt het nu al veel gebruikt door de afnemers??) waardoor:
Afnemer hierzo:
Wat ik wil is als volgt: -ik heb geografisch een perceel gevonden op de kaart, van dat perceel wil ik de gegevens van de zakelijk gerechtigden weten, inclusief adresgegevens -ik bevraag /kadastraalonroerendezaken/ met het perceelnummer, en een expand op de zakelijkgerechtigden -vervolgens bevraag ik in het geval van een kadaster_natuurlijk_persoon of kadaster_niet_natuurlijk_persoon de endpoints kadasternietnatuurlijkpersonen of kadasternatuurlijkpersonen, waarbij ik dan alleen geïnteresseerd ben in de adresgegevens van die persoon.
Voor zover ik kon zien krijg ik die adresgegevens bij de expand op zakelijkgerechtigden er niet bij, dus vandaar de 2e api call om die adresgegevens er bij te bevragen.
Zie issue #962
Probleem
Opvragen persoon of de kadastraalOnroerendeZaken bij een persoon waarbij er nu een timeout optreedt op de zakelijkgerechtigden.
Oplossing
Het mogelijk maken om een persoon op te vragen zonder de zakelijkgerechtigden erbij, door:
WAS:
Opvragen persoon
/kadasternietnatuurlijkpersonen/1
WORDT:
Opvragen persoon
/kadasternietnatuurlijkpersonen/1
Opvragen persoon met zakelijkgerechtigden als collectie
/kadasternietnatuurlijkpersonen/1?fields=omschrijving,woonadres,kadastraalOnroerendeZaakIdentificaties,statutaireNaam,statutaireZetel,rechtsvorm,links.kadastraalOnroerendeZaken,zakelijkGerechtigdenCollectie
Opvragen persoon zonder zakelijkgerechtigden
/kadasternietnatuurlijkpersonen/1?fields=omschrijving,woonadres,kadastraalOnroerendeZaakIdentificaties,statutaireNaam,statutaireZetel,rechtsvorm,links.kadastraalOnroerendeZaken
Kanttekening