Conformance checklist
You are conformant at the enrollment-sync level when all of these hold:
-
GET /.well-known/sdi-configurationreturns a valid discovery document over HTTPS, unauthenticated. - At least one OAuth grant works end-to-end; tokens are scoped;
403on insufficient scope. - If you support Dynamic Registration, it requires a software statement and/or initial access token.
- Access tokens are short-lived; refresh tokens (if issued) rotate with reuse detection.
-
GET {schema_endpoint}returns a valid Draft 2020-12 schema tagged with its contract version. -
POST {ingest_endpoint}validates per record, returns per-record results, applies valid records even when others fail, and is idempotent onIdempotency-Key+recordRef. - Repeated
recordRefupserts (no duplicates);externalIdreturned for created/updated. - If you accept documents: you resolve them by calling
resolveUrlwith a signed JWT assertion whoseaudis theresolveUrl, and you verifysha256after download. - Errors use
application/problem+json; you honourIdempotency-KeyandRetry-After. - If you localize: schema and error responses honour
Accept-Language, setContent-Language+Vary: Accept-Language, fall back todefault_language, and never translate property names, enum values, or errorcodes. - All endpoints are HTTPS; tokens travel only in the
Authorizationheader.