DCAT-AP-NL 3.0 naar API-register

Voorwaarden vanuit DCAT-AP-NL 3.0

• dct:publisher is verplicht
• dcat:endpointDescription is verplicht
• dcat:contactPoint is verplicht
• dcat:contactPoint moet een vcard zijn

Voorwaarden vanuit API-register

• dct:publisher MOET een TOOI identifier zijn (bijv. https://identifier.overheid.nl/tooi/id/gemeente/gm0344)
• Als dcat:endpointDescription een verwijzing is naar de bijbehorende OAS, dan MOET dct:conformsTo een verwijzing naar https://spec.openapis.org/oas bevatten
• Als dct:conformsTo geen verwijzing naar https://spec.openapis.org/oas bevat, dan MOET de bijbehorende OAS resolvable zijn op dcat:endpointUrl/openapi.json (ADR)
• dcat:contactPoint MOET vcard:fn, vcard:hasURL en vcard:hasEmail bevatten (ADR)
• Indien er geen meerdere talen voor vcard:fn zijn wordt de enige beschikbare genomen
• Indien er meerdere talen voor vcard:fn zijn, wordt de Nederlandse vertaling genomen

Proces

flowchart LR
1(Parse RDF/XML) --> 2(Fetch 0..n dcat:Dataservice)
2 --> 3{1..1 dct:publisher is TOOI URI?}
3 -- Ja --> 4[organisationUri = dct:publisher]
2 --> 5{0..n dct:conformsTo bevat https:\/\/spec.openapis.org/oas?}
5 -- Ja --> 6[oasUrl = dcat:endpointDescription]
5 -- Nee --> 7[oasUrl = dcat:endpointUrl/openapi.json]
2 --> 8[contact = dcat:contactPoint -> vcard:fn, vcard:hasURL en vcard:hasEmail]

Loading