Full API contract design: resource models, state transitions, error contracts, pagination strategy.
Design a REST or GraphQL API for the described domain. For each endpoint: 1. RESOURCE MODEL — JSON schema with types, required vs optional, nullable ...