start / glossary
Что такое API простыми словами + примеры
Все говорят «вызови API», «у этого сервиса есть API» — а что это? Объясним через ресторан и официанта. Плюс реальный запрос.
beginnerstartglossary
Открыть
Начальный15 мин
site / development
Интеграция стороннего сервиса
План подключения сервиса (Stripe, Supabase, etc.) с учётом ошибок, секретов и тестового режима.
integrationapithird-party
Открыть
Средний30-60 мин
site / development
Проектирование REST/RPC API
Ресурсы, эндпойнты, контракты, версионирование, ошибки, идемпотентность, rate limits.
apidesignrest
Открыть
Продвинутый30-60 мин
agents / tools
Дизайн кастомного инструмента для агента
Имя, параметры, описание, ошибки — так чтобы модель не путалась и вызывала правильно.
toolsagentsapi
Открыть
Продвинутый30-60 мин
code / docs
API-документация
OpenAPI/Swagger, описание endpoints, примеры запросов и ответов, ошибки.
docsapiopenapi
Открыть
Средний30-60 мин
code / architecture
API versioning: стратегия и deprecation
URL path vs Accept header vs media-type, deprecation timeline, sunset headers, как не застрять на v2 навсегда.
apiversioningrest
Открыть
Продвинутый30-60 мин
code / architecture
Идемпотентность: ключи, storage, retry
Idempotency keys (UUID), Redis storage с TTL, retry strategy, edge-cases с concurrent same-key и retry после success.
idempotencyapiretry
Открыть
Продвинутый1-2 часа