GCRI · Foundry

Developers and integrations

Foundry is designed to be integrated through versioned, documented interfaces rather than through private arrangements. This page, published by The Global Centre for Risk and Innovation (GCRI), explains how interfaces, software releases and documentation are managed, and what developers can expect as each is released. Interfaces open to external developers only with authorised projects. Information and enquiries are open today.

02Versioned interfaces

Contracts first, then code.

Contracts

Published contracts

Interfaces are described as machine-readable contracts, such as OpenAPI, with a version and a change log.

Versions

Change without surprise

Breaking changes take a new version. Earlier versions are deprecated with notice, not withdrawn silently.

Authorisation

Same gate for code

Every call is authorised by the policy gates of NXS-NSF (trust, authorisation and assurance), with OpenID Connect and OAuth for identity and delegation.

03Open standards

Standards the systems are designed to support.

AreaStandardsSystems
GeospatialOGC API Features, OGC API Records, STAC, Cloud Optimized GeoTIFF, GeoJSON, GeoPackageNXS-EOP (earth observation and digital twins), NXS-NST (civilian common operating picture)
WarningCommon Alerting Protocol 1.2NXS-EWS (multi-hazard monitoring and warning)
Provenance and cataloguesW3C PROV, DCAT 3, JSON-LD, SKOSNXS-GRX (canonical data, provenance and risk), NXS-POR (public, client and partner delivery), NXS-HUB (knowledge, records and learning)
Software supply chainSPDX, CycloneDX, SLSA provenance, in-toto, OCI imagesNXS-FAC (blueprints, builds and signing)
ObservabilityOpenTelemetryNXS-FAC
04Software releases

How software is built and released.

  1. 01

    Build

    The Factory system turns blueprints into tested applications with a software bill of materials and provenance.

  2. 02

    Sign

    Releases are signed and attestable. A release is not a deployment authorisation.

  3. 03

    Install

    The Apps system checks entitlement and compatibility and installs into a declared tenant environment, with rollback.

  4. 04

    Correct

    Defects and security fixes are released as new versions with notes.

05Documentation

Documentation is published as it is released.

Public technical documentation, examples and change logs are published on Foundry as each is reviewed for public release. Restricted documentation stays inside authorised projects. Each document states the version of the interface or release it describes, its date and its owner, and corrections are published as new versions rather than silent edits. Security issues go to the security report form, the security disclosure route.

06Questions

Questions and answers.

Is there a public API today?
No public API is offered yet. Interfaces open with authorised projects and their terms, and their documentation is published as it is released.
Can I build an application on Foundry?
Applications are built through the Factory and Apps systems inside authorised projects. Technology providers can start with GCRI pathways for technology providers.
How do I report a vulnerability?
Write to the security report form. Do not test against systems you are not authorised to use.
Are the interfaces open source?
Licensing is set in each release’s terms and its licence records. No licence is implied by this page.
Will old interface versions keep working?
The design deprecates a version with notice and a stated end date before it is withdrawn, so integrations have time to move. The change log records every change.
Foundry

Bring a method, a dataset or a question.

Information and enquiries are open today. An enquiry receives a reference and names the next step; applications, payments, compute allocations and registrations open only when their team, terms and review capacity exist.

The Global Centre for Risk and Innovation

Science · evidence · measurement

Not for profit

Our articles, maps and twins are free to read and free to republish. Readers and partners keep it that way.

Partner with us

Who funds us

GCRI is a not-for-profit institution. To ask who funds a piece of work, use the funding questions form.

Independence

Editors and the expert reviewers named on each article decide what we publish. Funders and partners do not review or approve articles before publication.

Licence

Articles: CC BY 4.0. Figures, maps, twins and data: CC BY 4.0. Other uses: ask through the permissions form.