Deep linking to resources

The OrganisatiePortaal application supports deep linking to resources from external applications.

How it works

OrganisatiePortaal has a "redirect" page which can redirect the user to the correct page. The only requirement is the URI of the resource you want to deep link to.

URL structure

To deep link to a certain resource the following URL structure can be used:

{{domain}}/redirect?resource={{resource URI}}

URL part	Description	Example value
{{domain}}	The base domain of the OP environment.	https://dev.organisaties.abb.lblod.info
{{resource URI}}	​The URI of the resource. This will be used to retrieve the necessary information to redirect the user to the correct page.	http://data.lblod.info/id/besturenVanDeEredienst/12345

Example URL

https://dev.organisaties.abb.lblod.info/redirect?resource=http://data.lblod.info/id/besturenVanDeEredienst/12345

Supported resource types

Deep linking is supported for the following resources:

Name	RDF type	Example resource URI
Persoon	http://www.w3.org/ns/person#Person	http://data.lblod.info/id/personen/12345
Bestuur van de eredienst	http://data.lblod.info/vocabularies/erediensten/BestuurVanDeEredienst	http://data.lblod.info/id/besturenVanDeEredienst/12345
Centraal bestuur van de eredienst	http://data.lblod.info/vocabularies/erediensten/CentraalBestuurVanDeEredienst	http://data.lblod.info/id/centraleBesturenVanDeEredienst/12345

If the provided resource URI belongs to a type that isn't supported yet, the user will be redirected to the homepage instead.

Authentication

Users will need to be authenticated before they can be redirected to the correct page. If the user isn't logged in to the OrganisatiePortaal application they will be redirected to the login page first (from which they can start the ACM/IDM login flow). After a successfully login the user will be redirected to the correct details page.

Usage example

Deep linking to (supported) resources is very easy. Simply generate a valid URL using the documentation above and use that as the href value of an <a> tag.

Here we link to a fictional "Bestuur van de eredienst" using the example resource URI that was mentioned in the "supported resource types" table.

<a href="https://dev.organisaties.abb.lblod.info/redirect?resource=http://data.lblod.info/id/besturenVanDeEredienst/12345">
  Bewerk in het OrganisatiePortaal
</a>

In the example we used the DEV environment (`https://dev.organisaties.abb.lblod.info`) as the base butany environmentwhere this functionality is available can be used.