API: проверяемые контракты, права и изменения

Кратко

API предоставляет операции и данные по контракту. Ценность зависит от задачи, обмена и контроля, а не от технологического прогноза.

Пустой защищённый коридор серверов и сетевого оборудования
В этой статье

API предоставляет операции и данные по контракту. Ценность зависит от задачи, обмена и контроля, а не от технологического прогноза.

Определить контракт

Документируйте объекты, поля, единицы, ошибки, ограничения и версии. Испытайте успех и сбой. Успешный HTTP-ответ не доказывает выполнение нужного делового действия.

Проверять каждый объект

Аутентификация не заменяет авторизацию объекта. В разрешённых рамках проверьте разделение пользователей, отзыв прав, повторы и восстановление. До изменений определите владельца, зависимости и проверки потребителей.

Проверки для сохранения

  • Сравнить с реалистичной базой.
  • Проверить разрешённый доступ.
  • Сохранить версии и ограничения.
  • Продолжить, ограничить или остановить по результатам.

Источники и область применения

Редакционная проверка ·