Networking
10 documents
API Design
Use REST with consistent conventions. Follow the platform API guidelines (Microsoft, Google,
Caching
Use HTTP caching headers. The server controls cache policy; the client honors it.
Error Responses
Use [RFC 9457 Problem Details](https://www.rfc-editor.org/rfc/rfc9457) format with
Offline and Connectivity
For apps that must work offline, design for local-first with background sync.
Pagination
Prefer **cursor pagination** for most APIs — stable under concurrent mutations, consistent
Rate Limiting
Respect server rate limits. Handle 429 responses gracefully.
Real-Time Communication
Choose the simplest technique that meets your needs.
References
1. [Microsoft REST API Guidelines](https://github.com/microsoft/api-guidelines)
Retry and Resilience
Not every failure is permanent. Retry transient failures with exponential backoff and jitter.
Timeouts
Always set both connection and read timeouts. Never use infinite timeouts.