REST API Rules
The concise rules for robust EpisodeTime clients.
- Use HTTPS and /api/v1.
- Keep API keys private and request only granted scopes.
- Store canonical EpisodeTime IDs.
- Use pagination and respect page-size limits.
- Handle nullable values and unknown additive fields.
- Handle 429 with Retry-After and bounded backoff.
- Cache public metadata responsibly.
- Do not depend on undocumented fields or scrape private routes.