Генерация ответов с помощью моков API
Моки API отвечают максимально реалистично на любые получаемые вызовы. При генерации тела ответа мок отдает приоритет данным, предоставленным пользователем, выполняя поиск поля примера, затем значения по умолчанию, а затем поля перечисления (enum). Если что-либо из этого найдено, оно будет использовано в качестве примера, в противном случае будет сгенерирован пример в формате JSON на основе типа данных, возвращаемого вызываемой операцией.
В качестве примера рассмотрим определение типа данных Company, показанное ниже. Оно не содержит никаких примеров, предоставленных пользователем.
Когда мокирование активировано, вызов GET к ресурсу /company/{companyId} вернет автоматически сгенерированный ответ в формате JSON на основе структуры типа данных.
Мок выполнил ряд интересных действий, включая генерацию значений для пользовательских заголовков ответа (например, x-my-custom-header), идентификацию массивов и создание соответствующих примеров (например, свойство tags), а также идентификацию вложенных структур и генерацию значений для них (например, свойство address).
Моки API Designer поддерживают согласование контента, поэтому вы можете использовать заголовок запроса Accept, чтобы выбрать, какое тело должно быть возвращено из нескольких вариантов (каждый из которых потенциально имеет свой собственный пример), тем самым изменяя примеры, возвращаемые моком.