Приходилось ли описывать OpenAPI спецификации?
Уточните, писали ли спецификацию OpenAPI самостоятельно, редактировали её или только использовали документацию. Приведите пример операции и частей контракта, за которые отвечали.
Читать ответПодготовка к интервью
28 вопросов по OpenAPI с технических собеседований
Что проверяют на интервью
На странице собраны вопросы по OpenAPI — от проверки базовых принципов до практического применения и архитектурных решений. В подборке чаще встречаются темы: backend, api, openapi.
Каталог
Уточните, писали ли спецификацию OpenAPI самостоятельно, редактировали её или только использовали документацию. Приведите пример операции и частей контракта, за которые отвечали.
Читать ответProtobuf задаёт схему бинарных сообщений, а OpenAPI описывает контракт HTTP API. Ни один формат сам по себе не гарантирует совместимость: она зависит от характера изменения и поведения клиентов.
Читать ответГенерация по OpenAPI создаёт типизированный клиент и модели из контракта API, уменьшая ручное дублирование, но не заменяя проверку данных во время выполнения.
Читать ответГенераторы обычно создают транспортные типы и клиенты по схеме API. Бизнес-модель приложения может совпадать с ними, но это отдельное архитектурное решение.
Читать ответРазделите ручное сравнение примеров и автоматическую проверку схемы, статусов и обязательных полей по OpenAPI.
Читать ответOpenAPI описывает контракт HTTP API, а Swagger — набор инструментов вокруг такого описания, включая документацию и генерацию клиентов.
Читать ответOpenAPI не ограничивает форматы тел запросов и ответов, но стандартно поддерживает любые форматы, которые можно описать через MIME-типы (Content-Type и Accept). Чаще всего используются:
Читать ответОписание контрактов должно быть комплексным: бизнес-язык важен для понимания требований и целей, а спецификация в OpenAPI (JSON или YAML) — для точного технического описания API.
Читать ответВ OpenAPI метод описывается внутри объекта paths, где ключ — это путь, а внутри — HTTP-метод (get, post, put, delete и т.д.). Разберём пример метода POST для создания пользователя:
Читать ответДа, OpenAPI спецификация позволяет описывать API прямо в формате YAML или JSON, где подробно указываются пути, методы, параметры, схемы данных и ответы.
Читать ответВ OpenAPI спецификации описывается REST API сервиса, включая:
Читать ответОтвет и пояснения приведены в подробном разборе ниже.
Читать ответ