Генерация ответов с использованием моков API

Моки API отвечают максимально реалистично на любые поступающие вызовы. При генерации тела ответа мок отдает приоритет данным, предоставленным пользователем, выполняя поиск поля примера, затем значения по умолчанию, а затем поля перечисления. Если он найден, он будет использован в качестве примера, в противном случае пример JSON будет сгенерирован на основе типа данных, возвращаемого вызываемой операцией.

В качестве примера рассмотрим приведенное ниже определение типа данных Company. Он не содержит примеров, предоставленных пользователем.

Когда активирован мокинг, GET-запрос к ресурсу /company/{companyId} вернет автоматически сгенерированный JSON-ответ на основе структуры типа данных.

Мок выполнил ряд интересных действий, включая генерацию значений для пользовательских заголовков ответа (например, x-my-custom-header), распознавание массивов и создание соответствующих примеров (например, для свойства tags), а также обнаружение вложенных структур и генерацию значений для них (например, для свойства address).

Моки API Contracts поддерживают согласование содержимого, поэтому вы можете использовать заголовок запроса Accept для выбора возвращаемого тела из нескольких вариантов (у каждого из которых может быть собственный пример), тем самым изменяя возвращаемые моком примеры.