Live Reference and OpenAPI
How to use the runtime-resolved Scalar and OpenAPI surfaces as the contract source of truth.
Live Reference
Use the runtime-resolved reference endpoints below for the authoritative API contract. These workflow pages are intended to complement the live reference, not replace it.
- API base
- waiting for runtime config
- Scalar endpoint
- waiting for runtime config
Scalar and the OpenAPI JSON are served by the API host. In production, use:
https://api.pixgruppe.de/documentationThe OpenAPI document advertises https://api.pixgruppe.de as the production server URL.
Authentication In Scalar
Scalar can exercise both supported auth modes:
- Browser session: sign in through
POST /v1/auth/loginon the same API host; the HttpOnly access-token cookie is sent automatically by same-origin Scalar requests. - External-client mode: paste a PAT into the bearer auth field.
Use PAT bearer auth when validating generated clients, automation, or server-side integrations. Use cookie session auth when validating browser workflows.
Contract Source
Use the runtime OpenAPI JSON for generated clients and contract checks. Do not copy schema files into application repositories unless the copy is part of a pinned release process.