Re: Sharing some real-world use of JSON-LD

Hi Alastair et al,


On Tue, 7 Oct 2025 at 13:31, Alastair Parker <alastair@jargon.sh> wrote:

> [..] I’m Al, founder of Jargon, a modelling tool that we use to generate
> JSON Schema, JSON-LD contexts, and related artefacts from composable domain
> models.
>

Nice to meet  you :)


> United Nations Transparency Protocol (UNTP):
> While I can’t speak on behalf of the UNTP team, I can share that the team
> use Jargon to model trade and supply-chain domains - a mix of UN-specific
> properties and references to established vocabularies like schema.org.
> From these models, the team generate both JSON Schema and JSON-LD contexts,
> and Jargon ensures they work together: the schema enforces mechanical @type
> properties that the context file then relies on for expansion
>

In Italy we implemented a similar mechanism to annotate existing and future
APIs with JSON-LD Keywords.
This approach will ensure that all APIs produced by more that 12k Italian
agencies will be semantically interoperable.

On each JSON Schema we associate:

- x-jsonld-type: representing the rdf:Class
- x-jsonld-context: representing the context.

This tool supports the annotation process and shows
the RDF generated by the schema example, and shows a semantic diagram of
the annotated schema (preview feature, still WIP):

- https://teamdigitale.github.io/dati-semantic-schema-editor/latest/

showing whether referenced classes are present or not on the national
SparQL endpoint provided on schema.gov.it

The relevant specifications (Linked Data Keywords, or LDK) are here:

 - https://www.ietf.org/archive/id/draft-polli-restapi-ld-keywords-07.html

@ratkinson Hi! Just saw the OGC approach now.
It is not far from LDK, but there are some major differences:

- LDK:x-jsonld-type only references rdf:Class, while iiuc OGC:x-jsonld-id
can reference both classes and properties
- LDK only annotate objects because a single scalar field cannot be
converted to RDF. See
https://www.ietf.org/archive/id/draft-polli-restapi-ld-keywords-07.html#appendix-C-2.18.1
- iiuc LDK:x-jsonld-context ~ x-jsonld-prefixes

Feedback welcome +
Have a nice day!
R.