Layer 3 · Побудова сервісів
API Design
Важливо вміти проєктувати передбачуваний API, який легко розвивати й масштабувати. А також правильно працювати з повторними запитами, навантаженням, версіонуванням і зовнішніми інтеграціями.
Що важливо знати
- Семантика HTTP: розуміти призначення HTTP methods, основні status codes, headers i caching semantics.
- Ідемпотентність: розуміти важливість ідемпотентності в контексті дизайну API, як зробити повторне виконання операції безпечним та де потрібні idempotency keys.
- REST: розуміти resource-oriented підхід, statelessness, роботу з representations, правильне використання HTTP methods та вміти проєктувати передбачувані API.
- Webhooks: розуміти push-модель інтеграцій, перевірку підпису запиту, retries, duplicate events, порядок доставки та необхідність ідемпотентної обробки подій.
- Pagination, filtering і sorting: розуміти offset vs cursor pagination, сортування та вміти спроектувати передбачуваний формат фільтрів.
- Версіонування: розуміти, як змінювати API в production, підтримувати backward compatibility і обирати найбільш підходящий підхід до версіонування.
- Rate limiting: розуміти проблему, яку вирішує цей підхід і вміти обрати найбільш оптимальну реалізацію.
- Throttling: розуміти різницю між жорстким відхиленням запитів і контрольованим обмеженням швидкості їх обробки.