Service description
This page describes the way we provide our catalogues' metadata via the https://marineinfo.org/ domain. By sharing this publicly we want to commit to persistently maintain these services and encourage automated interactions with this domain.
The core of this is the semantic (linked open data) publishing of the metadata managed in the Integrated Marine Information System. This is done via the following uritemplate:
https://marineinfo.org/doc/{type}/{id}, which represents the webpage about the entity.https://marineinfo.org/id/{type}/{id}, which represents the entity itself. In absence of any suffix, you are directed to the HTML webpage of the entity. Adding one of the other suffixes mentioned in the table below will result in a download of the entity in the specified serialization.
The {type} refers to the various catalogues in the system, these are:
- dataset: datasets about marine & related research
- publication: scientific publications about all kinds of marine & related research
- institute: institutes active in the marine research domain
- person: people involved in the marine research domain
- project: projects that are carried out within the marine research domain
- event: events that took place in context of the marine research domain
- collection: collections of any of the entities mentioned above, grouped together according to a certain context. (Note: A collection entity lists all contained entities, and as such provide useful overview lists of e.g. datasets and publications)
We provide these resources in different variant-representations over Content-Negotiation
name
URL-template
suffix
Set of Accept headers
sample link
html
https://marineinfo.org/doc/{type}/{id}
.html
Accept:text/html
Accept-profile:https://marineinfo.org/ns/profile#default
json
https://marineinfo.org/id/{type}/{id}
.json
Accept:application/json
Accept-profile:https://marineinfo.org/ns/profile#default
turtle
https://marineinfo.org/id/{type}/{id}
.ttl
Accept:text/turtle
Accept-profile:https://marineinfo.org/ns/profile#default
json-ld
https://marineinfo.org/id/{type}/{id}
.jsonld
Accept:application/ld+json
Accept-profile:https://marineinfo.org/ns/profile#default
xml
https://marineinfo.org/id/{type}/{id}
.xml
Accept:text/xml
Accept-profile:https://marineinfo.org/ns/profile#default
inspire
https://marineinfo.org/id/{type}/{id}
-inspire.xml
Accept:text/xml
Accept-profile:https://marineinfo.org/ns/profile#inspire
gcmd
https://marineinfo.org/id/{type}/{id}
-gcmd.xml
Accept:text/xml
Accept-profile:https://marineinfo.org/ns/profile#gcmd
eml2.1.1.
https://marineinfo.org/id/{type}/{id}
-eml-2.1.1.xml
Accept:text/xml
Accept-profile:https://marineinfo.org/ns/profile#eml2.1.1
eml2.2.0.
https://marineinfo.org/id/{type}/{id}
-eml-2.2.0.xml
Accept:text/xml
Accept-profile:https://marineinfo.org/ns/profile#eml2.2.0
profile html
https://marineinfo.org/doc/{type}/{id}
-alt.html
Accept:text/html
Accept-profile:http://www.w3.org/ns/dx/conneg/altr
profile ttl
https://marineinfo.org/id/{type}/{id}
-alt.ttl
Accept:text/turtle
Accept-profile:http://www.w3.org/ns/dx/conneg/altr
Ontologies coming soon.
Per catalogue a feed of recent changes is provided following the LDES specification.
This allows 3rd parties to efficiently synchronise up with the latest entries and updates in the IMIS system.
We make the various feeds available via this uritemplate https://marineinfo.org/feed/{type}.
See the 'LOD publishing of entities' section for the list of types.
type
feed
dataset
publication
institute
person
project
event
The following extra services are on the planning:
- DCAT feed – for the datasets, metadata sets from IMIS and each LDES feed (+ our service catalogue when it becomes available)
- OAI-PMH – harvesting service using the oai-pmh protocol
- search.marineinfo.org – search api into the available data
- marineinfo-widget – UI to the search api - plugable and configurable for inclusion in your website
- fair-signposting and service description