Лише інтерфейси, присутні в поточній опублікованій схемі OpenAPI під /api/v1/ підтримуються. URL-адреси інформаційної панелі не є загальнодоступними API.
Контракт спочатку
Візьміть кінцеві точки, методи, поля, дозволи та обмеження з OpenAPI; ніколи не винаходьте незадокументовану кінцеву точку.
Аутентифікація
Використовуйте HTTPS і маркер з найменшими привілеями. Ніколи не розміщуйте його в URL-адресі, пакеті браузера чи Git.
Сейф пише
За потреби використовуйте ключ ідемпотентності, збережіть ідентифікатор кореляції та перечитайте остаточний стан після тайм-ауту.
Помилки
Обробляти коди стану та форму відповіді, визначені схемою; зберігати конфіденційні деталі у корельованих журналах сервера.
