Conventions

This section describes the conventions every endpoint follows. Detailed content lands in Phase D — API narrative content.

• Pagination — page and pageSize query parameters across every list endpoint.
• Errors — RFC 7807 ProblemDetails with a traceId correlating to Sentry.
• Idempotency — IdempotencyKey on order creation prevents double-charges.
• Rate limits — 120 requests per minute per API key.