Новые возможности JoinAPI: интеграция с Postman и Swagger

В JoinAPI добавлена функция автоматической генерации клиентских коллекций и технической документации на основе создаваемой модели данных. Теперь при проектировании структуры API в веб-интерфейсе система формирует не только серверный код, но и готовые артефакты для тестирования и интеграции.

Генерация охватывает два направления: 

  • Первое - коллекции для Postman и Insomnia с настроенными заголовками, переменными окружения и примерами запросов, соответствующими спроектированным объектам и типам данных. 
  • Второе - спецификация OpenAPI, совместимая со Swagger, которая описывает все эндпоинты, схемы данных и правила доступа. Оба артефакта обновляются автоматически при изменении структуры API, что исключает рассинхронизацию документации с реальным кодом.

 

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

 

Чтобы познакомиться с новым функционалом, создайте новый проект в JoinAPI или откройте обновленный раздел документации - там подробно описан процесс генерации коллекций и спецификаций для вашего API.

Есть задача?

Напишите нам!