THE REFERENCE SHELF
From schema
to understanding.
Practical guides for reading, joining, and validating the fixtures.
Every example comes with a clear place to start.
Your first resource query
Fetch a fixture, filter available stations, and check the result against a known answer.
API conventions
Resource envelopes, identifiers, field types, versioning, and the read-only REST and MCP surfaces.
Query recipes
Join station names to transfers, aggregate capacity, and avoid double-counting lifecycle events.
Schemas and validation
Validate primitive types, enums, timestamps, and relationships with explicit positive and negative examples.
Lifecycle and ordering
Reconstruct queued, in-transit, and delivered states from ordered events without assuming arrival order.
HTTP status codes
A selected guide to response classes, common codes, redirects, retries, and the headers that change what a client should do.
HTTP headers
A selected guide to request and response fields that describe content, caching, authentication, redirects, and retries.
Assistant API
Ask the scripted resource assistant about schemas and examples through a token-scoped JSON conversation.
The relay network is fictional; the examples are runnable. For a combined plain-text reference, open llms-full.txt.