Mobile clients draaien op onbetrouwbare netwerken. API's moeten round trips minimaliseren, incrementele sync ondersteunen en errors teruggeven die apps kunnen tonen zonder cryptische codes.

Ontwerpprincipes die wij volgen

  • Consistente JSON-vormen en gedocumenteerde errortypes
  • Cursor-based paginering voor grote lijsten
  • Idempotente writes voor onstabiele verbindingen

Goed API-design vermindert batterijverbruik en supporttickets—beide tellen net zo zwaar als feature count voor retentie.