Опишіть обмін
Для кожної операції документуйте метод, ресурс, необхідні поля та форму успішної відповіді. Включіть помилку перевірки. Розрізняйте збій транспорту та відхилений запит: відсутність відповіді не доводить, що операція, що змінює стан, зазнала невдачі.
Розглядайте облікові дані як конфігурацію
Зберігайте серверні облікові дані поза пакетами браузера та репозиторіями джерел. Запитуйте найменший корисний набір дозволів і розділяйте доступ для розробки та доступ у продакшн. Записуйте, хто володіє кожною інтеграцією та як можна відкликати доступ. Дотримуйтесь задокументованого постачальником потоку авторизації.
Плануйте на випадок недоступності залежностей
Встановлюйте таймаути, дотримуйтесь рекомендацій щодо обмеження частоти запитів і повторюйте операцію лише тоді, коли її безпечно виконувати повторно. Там, де це підтримується, ключ ідемпотентності може ідентифікувати повторювані запити. Реєструйте ідентифікатор запиту та стислу категорію збою; уникайте використання заголовків авторизації, сесійних куки та персональних даних у повідомленнях.