Mobile clients live on unreliable networks. APIs should minimize round trips, support incremental sync, and return errors that apps can show without cryptic codes.
Design principles we follow
- Consistent JSON shapes and documented error types
- Cursor-based pagination for large lists
- Idempotent writes for flaky connections
Good API design reduces battery drain and support tickets—both matter as much as feature count for retention.
