Вставьте документ OpenAPI 3.x в поле "Спецификация OpenAPI". Поддерживаются YAML и JSON.
Что нужно указать:
- Валидный документ OpenAPI 3.x с paths, parameters, request bodies и responses
- При необходимости ссылки в components.schemas для разворачивания схем тела запроса
- Необязательный Base URL, если вы хотите отправлять сгенерированные кейсы в реальный backend
Как работают поля:
- Спецификация OpenAPI: вставьте полный контракт в YAML или JSON
- Базовый URL: оставьте пустым для офлайн-генерации кейсов или укажите что-то вроде https://api.example.com для выполнения запросов
- Выполнять реальные запросы: при включении инструмент отправляет сгенерированные невалидные и граничные запросы на Base URL
- Заголовок авторизации: необязательное сырое значение, например Bearer
- Максимум кейсов на поле: ограничивает число граничных кейсов для каждого параметра или поля тела запроса
- Таймаут запроса (мс): ограничивает время выполнения каждого реального запроса
Что проверяется:
- Отсутствующие обязательные поля
- Пустые, слишком короткие и слишком длинные строки
- Недопустимые значения enum
- Числа ниже minimum или выше maximum
- Неверные скалярные или массивные типы для задокументированных полей
Примечания:
- Если реальные запросы выключены, инструмент только генерирует план контрактного тестирования.
- Если включены, в отчете отмечается, задокументирован ли каждый наблюдаемый HTTP-статус в responses.
- Покрываются path, query, header и JSON body; текущая версия ориентирована на application/json.