Статья
Типобезопасные API-контракты: tRPC, OpenAPI, GraphQL и кодогенерация
Как не дать типам клиента и сервера разъехаться: три подхода к контракту, кодогенерация в CI и правила эволюции API.
База знаний
Тема: api
15 материалов в этой теме.
Материалы
12 на странице
Статья
Тестирование API: REST, GraphQL, gRPC, схемы и инструменты
Как тестировать программные интерфейсы: что реально проверять в ответе REST, чем принципиально отличается GraphQL и gRPC, как использовать OpenAPI и proto как источник …
Статья
Стили API: REST, GraphQL, gRPC, вебхуки и версионирование
Как выбирать между ресурсным REST, RPC-стилем gRPC, графовым GraphQL и push-моделью вебхуков, что на самом деле означает совместимость контракта и как менять API так, …
Статья
Совместимость: как менять то, чем уже пользуются
Закон Хайрама, виды совместимости, честные границы SemVer, правила эволюции схем данных и БД, совместимость во время выкатки и депрекация как управляемый процесс с …
Статья
Обработка ошибок: Result, Option, оператор ?, свои типы ошибок
Ошибка как значение и как часть контракта: чем Option отличается от Result, что на самом деле делает оператор ?, как спроектировать свой тип ошибки, где место thiserror и …
Статья
Коннекторы и приём данных: SaaS API, файлы, вебхуки и дрейф схемы
Как устроен слой приёма данных из внешних систем: анатомия коннектора, пагинация и лимиты API, состояние и чекпоинты, файловые дропы и вебхуки, реакция на дрейф схемы, …
Статья
Инфраструктура как API: декларативность, каталог, шаблоны сервисов
Как превратить выдачу инфраструктуры в контракт: декларативная модель ресурса и сходимость, версионирование API, каталог как производная от реальности, шаблоны сервисов и …
Статья
Интеграция: как части системы разговаривают друг с другом
Контракт между двумя частями системы: эволюция способов интеграции, синхронное и асинхронное взаимодействие, проектирование API, поведение при сбоях и изменение контракта …
Статья
Документация API: справочник, примеры, контракт
Под словом «документация API» живут три документа с тремя читателями: справочник для того, кто уже пишет код, примеры для того, кто оценивает вас за пятнадцать минут, и …
Статья
Веб и API: FastAPI, Django, валидация, асинхронные приложения
WSGI против ASGI как две модели исполнения, FastAPI и Pydantic v2 как контракт данных, Django и его ORM, асинхронные обработчики без блокировок, фоновые задачи, запуск в …
Статья
Безопасность API: rate limiting, IDOR, массовое присвоение, валидация
Почему у API нет интерфейса, который что-то прячет: BOLA и IDOR, массовое присвоение и утечка полей, валидация как контракт, token bucket на Redis, SSRF из вебхуков и …
Статья
Анализ интеграций и API: контракты, форматы, сценарии обмена, ошибки
Как аналитик работает на границе систем: карта интеграций, восемь слоёв контракта, ловушки форматов, обязательные сценарии обмена, контракт на ошибки и бюджет таймаутов, …
По этому запросу ничего не найдено.