stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 16 Releases Wiki Activity
Files
d519782a8f0b30f425c9b6ae0f316b19259972a2
git.stella-ops.org/docs/modules/export-center/prep/2025-11-20-export-oas-61-002-prep.md
master d519782a8f
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details
prep docs and service updates
2025-11-21 06:56:36 +00:00

1.0 KiB
Raw Blame History

Export OAS Discovery Prep — PREP-EXPORT-OAS-61-002-DEPENDS-ON-61-001

Status: Draft (2025-11-20) Owners: Exporter Service Guild Scope: Define the OpenAPI discovery endpoint once base OAS (61-001) is frozen.

Requirements

  • Endpoint: GET /.well-known/openapi (and .json alias) returning latest Exporter OAS.
  • Headers: ETag, Last-Modified, Cache-Control: public, max-age=300; support If-None-Match for 304.
  • Body: JSON with fields {version, oas_url, checksum_sha256, generated_at, profiles_supported} plus embedded OAS or link.
  • Determinism: stable ordering of fields; checksum over canonical OAS JSON.

Acceptance

  • Once 61-001 OAS is fixed, publish generated OAS path and checksum into this doc and docs/modules/export-center/api.md.
  • Add sample discovery response at docs/events/samples/export-center.openapi.discovery@draft.json.

Handoff

Use this as the prep artefact for PREP-EXPORT-OAS-61-002-DEPENDS-ON-61-001. Update checksums/links when 61-001 finalizes, then mark implementation DOING.