Set Up API Clients
How to configure base URLs, transport conventions, and reference tooling for PixService clients.
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
Configure clients from the runtime API base URL shown above. Production uses https://api.pixgruppe.de.
Browser Clients
Browser clients should use cookie-backed sessions:
await fetch(`${apiBaseUrl}/v1/users/me`, {
credentials: 'include',
});Keep frontend origins aligned with API configuration. Cookie-authenticated unsafe requests are accepted only from the API origin or configured frontend origins.
External Clients
External clients should use a PAT:
export API_BASE="https://api.pixgruppe.de"
curl -H "Authorization: Bearer $PIX_PAT" "$API_BASE/v1/auth/tokens"Generated clients should read the OpenAPI document from the runtime OpenAPI URL shown above, not from a checked-in copy.