Read a contract version
Reads one registered contract version: its schema, references, content hash and status. Your deploy pipeline calls it to verify the identity, the content hash and the ACTIVE status before the producer rolls out.
Rules
- A version is addressed by all four segments: producer, namespace, fact type and schema version.
- Each reference shows the scope and sensitivity of its reference type.
Responses
200the contract version,ACTIVEorDEPRECATED.404SF-0017no version is registered under this identity.503SF-0094retry later.
Autorizaciones
JWT issued by the identity provider. A producer calls with a service credential issued for the tenant it sends facts for; a reader calls with a user token or a service credential. The tenant is always taken from the token, never from the request path, query or body.
Parámetros de ruta
Producer service that owns the fact type.
"checkout-api"
Namespace of the fact type.
"acme.checkout"
Fact type name.
"checkout.order_placed"
Semantic version of the contract (major.minor.patch).
"1.0.0"
Respuesta
The contract version as registered, with its content hash and its status (ACTIVE or DEPRECATED).
When this version was registered. RFC 3339, UTC.
Content hash verified at registration (the prefix sha256: plus 64 hex characters); the authoritative integrity value of this version.
Namespace of the fact type, bound to the producer that registered in it first.
"acme.checkout"
Producer service that owns the fact type.
"checkout-api"
References facts of this type carry, each with the scope and sensitivity its reference type had at registration.
Payload schema as stored: member order, whitespace and number spelling may differ from what was sent, so check integrity with hash, never by rehashing this.
Semantic version of this contract (major.minor.patch).
"1.0.0"
Lifecycle status: a DEPRECATED version refuses new facts and never returns to ACTIVE. Allowed values: ACTIVE, DEPRECATED.
ACTIVE, DEPRECATED Owning team or squad, as registered; informational and audited, never an identity.
"checkout-squad"
Fact type name, chosen by the producer.
"checkout.order_placed"
How a new version is checked against the earlier versions of its major. Allowed values: TRANSITIVE.
TRANSITIVE 
