generated: '2026-09-13'
method: derived
source: openapi/es-pera-openapi.json + https://es-pera.org/.well-known/api-catalog + live response probes
name: ES·pera API conformance
entries:
  - id: rfc9727-api-catalog
    conforms: true
    evidence: >-
      https://es-pera.org/.well-known/api-catalog returns HTTP 200 with
      content-type application/linkset+json;profile="https://www.rfc-editor.org/info/rfc9727",
      a valid RFC 9727 linkset resolving service-desc (OpenAPI), service-doc (docs) and status.
  - id: openapi-3.1
    conforms: true
    evidence: 'openapi/es-pera-openapi.json declares "openapi": "3.1.0" and parses as valid OpenAPI 3.1.'
  - id: offset-pagination
    conforms: true
    evidence: >-
      Pagination schema exposes limit/offset/returned/hasMore/nextOffset on
      /waiting/observations (offset-limit pagination).
  - id: ratelimit-headers
    conforms: true
    evidence: >-
      429 TooManyRequests response declares RateLimit-Limit, RateLimit-Policy
      (e.g. "120;w=60") and Retry-After per the IETF RateLimit header fields draft.
  - id: rfc9457-problem-details
    conforms: false
    evidence: >-
      Error responses use a custom envelope { error: { code, message } } with content-type
      application/json, not application/problem+json; no RFC 9457 fields (type/title/status/detail).
domain_standard: none
domain_standard_note: >-
  The contract carries no declared healthcare domain standard (no FHIR resource types, HL7,
  SCIM, OData, or similar). ES·pera republishes aggregate Spanish SNS waiting-list open data
  under its own bespoke schema; its market has no machine-contract standard to declare here.