ContextLink

De context waaraan de taak is gekoppeld (bijv. een zaak of product), aangeduid met een URN en optioneel een canonicalUrl.

canonicalUrl is afwezig als de dienstverlener geen eigen portaal heeft (bijv. bedrijfsonderdelen die geen eigen portaal hebben).

Portalen die de URN kunnen omzetten naar een interne URL doen dat; canonicalUrl is dan irrelevant. Anders geldt: gebruik canonicalUrl als die aanwezig is. Het type context is af te leiden uit de URN-structuur.

urnstringrequired

Portaal-agnostische identifier van de context, in URN-formaat.

Possible values: Value must match regular expression ^urn:

Example: urn:nl:gemeenten:zaak:2026-00042

canonicalUrluri

Optionele URL naar de context in de omgeving van de dienstverlener. Afwezig als de dienstverlener geen eigen portaal heeft. Als aanwezig, bruikbaar als directe link voor portalen die de URN niet zelf omzetten. Portalen met eigen contextondersteuning kunnen deze URL negeren en een interne URL opbouwen via de URN.

Example: https://portaal.gemeente.nl/zaken/2026-00042

ContextLink

{
  "urn": "urn:nl:gemeenten:zaak:2026-00042",
  "canonicalUrl": "https://portaal.gemeente.nl/zaken/2026-00042"
}