API automation и контракты

API-автотесты обычно быстрее и стабильнее UI, поэтому хорошо подходят для бизнес-правил, контрактов, прав доступа и негативных сценариев. Их ценность растёт, когда они проверяют смысл ответа и побочные эффекты.

Что важно понять

  • Контракт ответа: schema, обязательные поля, типы, совместимость.
  • Бизнес-правила и переходы состояний.
  • Права доступа, rate limits, idempotency, conflict handling.
  • Изменение данных, события и audit trail после запроса.

Рабочий порядок

  1. Разделите тесты на contract, business flow и security/permissions.
  2. Генерируйте или подготавливайте данные изолированно.
  3. Проверяйте и ответ, и состояние системы после операции.
  4. Запускайте API suite в CI до тяжёлых E2E.

Что отдавать команде

  • API test suite.
  • Contract schemas.
  • Отчёт по endpoint, статусу и причине падения.

Частые провалы

  • Оставлять тесты как коллекцию ручных запросов без assert.
  • Делиться тестовыми данными между параллельными запусками.
  • Не отличать contract breaking change от ожидаемого изменения версии.

Практика

Автоматизируйте проверку создать заказ: response schema, запись заказа, невозможность создать дубль с тем же idempotency key.