GET /v1/openapi.json
| Method and path | GET /v1/openapi.json |
| Key | not needed |
| Response | an OpenAPI 3.1 document |
| Lean OpenAPI | getOpenApi |
| Full contract | getOpenApi |
Available now The served document describes the lean v1 routes as deployed. Point code generators, Postman, Insomnia or Swagger UI at it:
curl -s -o openapi.json https://api.satellitedata.net/v1/openapi.jsonThe landing page links to it with rel: service-desc. Its info.version is 1.0.0-lean.1.
The same document is browsable on this site: Lean v1, available now (interactive).
The full contract
Section titled “The full contract”The full v1 contract on this site is generated from the design’s OpenAPI document: 31 operations across phases P1 to P4. Each operation carries x-phase, the build phase it ships in, and x-units, its planned metering formula. The document also carries x-quotas (tiers), x-limits (hard caps) and x-units-model.
Routes in the full contract that lean v1 does not serve answer 404 not-found until their phase ships.