В этом выпуске мы с Денисом Семененко, Principal Software Engineer в DocGo, обсуждаем разработку REST API, спецификации, преимущества и недостатки инструментов типа TypeBox и TypeSpec, и как понимание всех этих аспектов влияет на процесс проектирования. ✅ Подписывайтесь на канал «Организованное программирование» в Telegram– Список подкаст-платформ (Apple Podcast, Google Podcast, Spotify, Яндекс.Музыка и другие)– Смотреть в ВК Видео– Смотреть в Youtube Мы затронем исторический контекст REST, его ограничения и концепцию HATEOAS для построения гибких интерфейсов. Также рассмотрим, как REST и RPC решают схожие задачи и чем отличаются JSON API и GraphQL, поговорим про OpenAPI и Async API, стандарты обработки ошибок, перемещение логики на промежуточные серверы и разделение ответственности между клиентом и сервером. В общем в этом эпизоде очень много о программировании и архитектуре. Полезные ссылки: Твиттер Дениса: https://twitter.com/denblackstacheТред про REST API: https://x.com/mokevnin/status/1824512290793853328Hypermedia Factors. Факторы для сравнения разных message formats между собойhttp://amundsen.com/hypermedia/hfactor/AsyncAPI https://www.asyncapi.com/OpenAPI Tools https://openapi.tools/Книга Сергея Константинова https://twirl.github.io/The-API-Book/API.en.html00:00 Обсуждение REST и API08:55 Инструменты и спецификации для API12:44 Инновации в программировании с Closure20:09 TypeSpec: Будущее описания API24:47 Сравнение подходов к описанию API29:54 Сравнение OpenAPI и альтернативных решений34:36 Книга Сергея Константинова и мифология REST39:11 Понимание hateOS и его значение42:07 Гипермедиа и его роль в вебе44:31 Динамическое построение интерфейсов46:54 Проблемы с реализацией API48:54 Преимущества REST по сравнению с RPC51:18 Перемещение логики на промежуточный сервер54:33 Стандарты обработки ошибок в API59:45 Сравнение JSON API и GraphQL01:04:31 Проблемы упаковки данных в JSON01:07:41 Форматы сообщений и обратная совместимость01:10:42 Семантический веб и его влияние на API01:12:56 Гибкое выборочное представление контента01:14:53 Разнообразие форматов API и их применение01:17:05 Стандарты API и их эволюция01:20:40 Выбор технологий для построения API01:23:52 Frontend и API: как строить взаимодействие01:25:49 ГрафQL: хайп и реальность01:29:11 Проблемы и ограничения GraphQL01:29:42 Оптимизация REST API и его преимущества01:30:12 Знакомство с Ransack и его концепцией01:31:14 Фильтрация данных и ее сложности01:32:53 Преимущества Ransack в фильтрации01:35:34 Использование Doreos и Grape для API01:37