Возможно, имелись в виду различия между OpenAPI и некоторыми другими спецификациями REST, например RAML и API Blueprint. info.gosuslugi.ru starkovden.github.io
Некоторые особенности OpenAPI:
- Формализованный стандарт. info.gosuslugi.ru OpenAPI описывает интерфейс к REST API-сервису и позволяет определять его возможности без доступа к исходному коду или документации. info.gosuslugi.ru
- Независимость от языка программирования. info.gosuslugi.ru stackoverflow.com Спецификация удобна в использовании как человеком, так и машиной. info.gosuslugi.ru
- Поддержка передачи бинарных данных. dzen.ru OpenAPI поддерживает такую возможность для спецификаций через тип «стринг». dzen.ru
- Возможность использования в нескольких спецификациях одних и тех же объектов данных. dzen.ru Это реализовано через конструкцию «!ref». dzen.ru
- Предоставление основы каждой конечной точки. github.com OpenAPI описывает описание, параметры, пример запроса и ответа. github.com
REST API в целом больше является архитектурным стилем, а не стандартом написания собственных сервисов. info.gosuslugi.ru При этом разработано несколько спецификаций REST, и OpenAPI считается одной из популярных. info.gosuslugi.ru starkovden.github.io