Upload
roman-krivtsov
View
95
Download
7
Embed Size (px)
Citation preview
Swagger
Зачем использовать API
фреймворки?
• Автогенерация кода• Документация• Автовалидация• Тесты• Клиент• Красивый UI
UI
Editor
Swagger 2.0 ≠ Swagger 1.2
– Почти полная поддержка JSON schema
– Смена идеологии
– Поддержка YAML
– Новый формат полей
Спецификация
Параметры
{
Параметры
Модели
– Наследование
– Полиморфизм
– Ссылки
Авторизация
Тип Заголовок
Basic Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
ApiKey api_key: 22555afccfcd7c2e32392a027
OAuth2 Authorization: Bearer mF_9.B5f-4.1JqM
Top-down vs Bottom-up
спецификация
реализация
swagger-node-express
swaggerize-express
swagger-codegen
C#
+ templates}
client + server+ docs
2.0
Что есть еще
Apiblueprint
– YAML
– !include
– traits
WORKGROUP:
WADL
Выводы• Большое сообщество и экосистема (>45
сервисов)• Поддержка большого кол-ва языков (>13)• Богатые возможности спецификации• Визуальные инструменты• Платформонезависимость
• Зоопарк сторонних библиотек• Несоответствия библиотек спецификациям• Исторически bottom-top идеология
+
–
Спасибо
@raxpost
http://yarax.ru
http://facebook.com/raxwunter