Clienții mobili trăiesc pe rețele nesigure. API-urile ar trebui să minimizeze round trip-urile, să suporte sincronizare incrementală și să returneze erori pe care aplicațiile le pot afișa fără coduri criptice.

Principii de design pe care le urmăm

  • Forme JSON consistente și tipuri de erori documentate
  • Paginare bazată pe cursor pentru liste mari
  • Scrieri idempotente pentru conexiuni instabile

Un design API bun reduce consumul de baterie și tichetele de suport—ambele contează la fel de mult ca numărul de funcționalități pentru retenție.