Alleen gegevens vastgelegd in de bronregistratie van de provider van de API worden opgenomen

[melsk-r]

In de API worden alleen gegevens opgenomen die zijn vastgelegd in de bronregistratie van de provider van de API. Een van de consequenties daarvan is #46 het niet embedden van resources uit een andere registratie. Een andere consequentie is het niet opnemen van kerngegevens. Dus de regel is halen bij de bron, een consequentie (toelichting of voorbeeld) is het niet opnemen van gemeentelijke kerngegevens en plusgegevens.

Ratio: Het opnemen van gegevens uit een andere bron zorgt voor tight coupling met die andere bron. Ook kan een bronsysteem niet zomaar gegevens uit een andere bron halen, zeker niet wanneer dat gegevens zijn waar autorisaties voor nodig zijn (zoals privacy gevoelige gegevens). Tenslotte verhoogd het tevens moeten ontsluiten van gegevens uit andere bronnen de complexiteit nodeloos.

[melsk-r]

JBo: Niet overnemen
HK:
RM: Discussie
MV:
GJ: Bespreken
JBi: Dit lijkt me alleen van toepassing op API op bronnen. Niet op bijvoorbeeld convenience API's

JBo: Dit gaat niet op voor bv samensgeteld convenience API's
RM: Eens met de opmerking van JBo maar wellicht kunnen we deze DD wel laten gelden voor systeem API's.
GJ: scope van deze design decision zou moeten zijn alleen voor APIs op bronnen? Mag je wel verwijzen naar een bron waar je alzodanig relevante / nuttige gegevens dan wel kunt ophalen?