История одной команды в консоле для преобразования OpenAPI 2 на OpenAPI 3

История одной команды в консоле для преобразования OpenAPI 2 на OpenAPI 3

На работе переходим на контрактное программирование. В рамках задачи нужно было выполнить миграцию с OpenAPI 2 на OpenAPI 3. Я человек простой: надо — значит надо. Сел, скопировал файл, поменял версию, руками поправил все ошибки. Жалкие 2 дня и всё готово. Проходит время. Оказывается, не всё сложилось как надо и теперь надо снова взять актуальную спецификацию Swagger 2.0 и перевести в OpenAPI 3.0. С одной стороны, я знаю, что справлюсь за те же 2 дня. С другой тратить их так бездарно во второй раз не хочу. А вдруг будет третий раз? Четвёртый? Жизнь непредсказуема. ...

20 февраля 2026 г. · 2 минуты · CrazyElephant_x
'Проектирование RESTful API: фильтрация, сортировка и пагинация'

Проектирование RESTful API: фильтрация, сортировка и пагинация

Проектирование RESTful API сегодня — фундамент современной веб-разработки, дающий возможность создавать мощные, масштабируемые и эффективные веб-приложения. Для оптимального пользовательского опыта и высокой производительности сервера при проектировании таких API критически важны три функции: фильтрация, сортировка и пагинация. Фильтрация позволяет пользователям сужать результаты по заданным критериям. Сортировка помогает упорядочивать данные нужным образом. Пагинация же разбивает большие наборы данных на части, снижая объем передаваемой информации и повышая скорость работы системы. В этой статье мы подробно разберем значение фильтрации, сортировки и пагинации для REST API. Вы узнаете о разных подходах к пагинации, таких как курсорная (cursor-based) и офсетная (offset-based), и увидите примеры их реализации. Также мы рассмотрим лучшие практики применения фильтрации и сортировки в API-запросах. Это включает: Синтаксис параметров запроса. Алгоритмы сортировки. Прочитав материал, вы получите четкое представление о том, как проектировать и внедрять эти ключевые механизмы в свои RESTful API. ...

23 июля 2025 г. · 3 минуты · CrazyElephant_x
gRPC

gRPC

**gRPC (Google Remote Procedure Calling) ** — это современный высокопроизводительный фреймворк для удаленного вызова процедур (RPC), разработанный Google. Он использует HTTP/2 для передачи данных и Protocol Buffers (Protobuf) в качестве формата сериализации. gRPC поддерживает несколько режимов взаимодействия: унарные вызовы, серверные потоки, клиентские потоки и двунаправленные потоки. ...

27 января 2025 г. · 2 минуты · CrazyElephant_x
API driven development

API driven development

API driven development — это методология программирования, которая ставит API в центр внимания и разработки. ...

4 января 2025 г. · 2 минуты · CrazyElephant_x
Примеры документации API для вдохновения от крупных мировых компаний

Примеры документации API для вдохновения от крупных мировых компаний

REST API Spotify Музыкальная стриминговая платформа Spotify предоставляет RESTful API, который позволяет разработчикам создавать приложения, которые взаимодействуют с каталогом Spotify, плейлистами, артистами и многим другим. Spotify Web API Открытый банкинг Платформа для получения доступа к финансовым услугам. Спецификации для среды Открытых банковских интерфейсов SOAP API PayPal Для некоторых из своих сервисов PayPal предоставляет SOAP API, позволяя интегрировать возможности оплаты и управления транзакциями. PayPal SOAP API Пример метода получения баланса для удобства. ...

13 ноября 2023 г. · 1 минута · CrazyElephant_x