Data formats

Gazette notices can be submitted as either documents containing the full text of the notice or as data where the only the variable elements of the notice are provided and this is then merged with a template to produce a full notice. During the submission of the notice in both instances the data elements within the notice are marked up using the RDFa syntax and enriched with information from other data sources. As the notice is published the RDFa is extracted from the notice and stored as RDF in a triple store. This provides us with both document views of the notice i.e. the whole textual content of the notice and data views of the notice i.e. the entities which have been identified within the notice.

The Gazette API allows the different representations of a notice to be retrieved via format specific URIs as described in the table below:

Response type Notes
/notice/{notice-id}
/notice/{notice-id}/data.htm
(X)HTML5+RDFa Website view of the notice with all of the page chrome included.
/notice/{notice-id}/data.xml (X)HTML5+RDFa Contains only the notice content
/notice/{notice-id}/data.pdf PDF
/notice/{notice-id}/data.ttl TTL
/notice/{notice-id}/data.rdf RDF
/notice/{notice-id}/data.jsonld JSON LD
/notice/{notice-id}?view=linked-data HTML HTML representation of the data view of the notice
/notice/{notice-id}/data.ttl?view=linked-data TTL
/notice/{notice-id}/data.rdf?view=linked-data RDF/XML
/notice/{notice-id}/data.rdfjson?view=linked-data RDF/JSON
/notice/{notice-id}/data.json?view=linked-data JSON LD
/notice/{notice-id}/data.xml?view=linked-data XML Linked data XML view containing the only data elements of the notice

The Gazette API also supports content negotiation so using the document URIs in the table below and the Accept header set to the media type specified content can be retrieved in all the available formats.

Generic Document URI Accept header Response type Matching Representation*
/notice/{notice-id} application/ld+json JSON LD
application/rdf+xml RDF
text/turtle TTL
application/xml (X)HTML5+RDFa /notice/{notice-id}/data.xml
text/html (X)HTML5+RDFa /notice/{notice-id}
/notice/{notice-id}/data.htm
*/*
/notice/{notice-id}?view=linked-data application/rdf+xml RDF/XML
application/rdf+json RDF/JSON
text/turtle TTL
application/json JSON
application/xml XML
text/html HTML

Various other key elements of content available in The Gazette platform such as search results and historic pages are also available in various representations. For more information regarding the available content, formats available and ways of accessing please refer to The Gazette Developer Documentation which contains far more information.