[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"glossary-api-deprecation::ru":3,"gloss-cluster-api-deprecation::ru":23,"gloss-next-api-deprecation::ru":9},{"slug":4,"category":5,"name":6,"definition":7,"meta_desc":8,"faq":9,"schema_markup":9,"related":10},"api-deprecation","integration","Устаревание API","Устаревание API (deprecation) — это объявление поставщика о том, что эндпоинт, поле, способ аутентификации или целая версия API перестанут работать в названную дату. С места публикующей стороны это уборка. С места всех, кто выстроил на этом интеграцию, это незапланированная инженерная работа со сроком, который назначил кто-то другой, и один из немногих рисков интеграции, который не вероятен, а неизбежен.\n\nПервая проблема — как вы об этом узнаёте. Уведомления приходят через журнал изменений, через заголовок, тихо добавленный в ответы, через письмо на адрес, с которого регистрировали приложение, — часто это разработчик, давно уволившийся, — и через баннер в панели, куда никто не заходит после того, как интеграция заработала. Команда может находиться внутри окна отключения месяцами, и первым сигналом станет обращение в поддержку в тот день, когда эндпоинт начнёт возвращать ошибку.\n\nВторая проблема в том, что стоимость миграции редко пропорциональна размеру изменения. Переименовать поле — работа на полдня. Сменить способ аутентификации — значит затронуть каждый сохранённый вами доступ от имени каждого клиента и, как правило, потребовать, чтобы каждый из них нажал кнопку; это уже не правка кода, а проект по коммуникации с клиентами. Отключения к тому же приходят пачками — после поглощения, переписывания платформы или инцидента безопасности, — поэтому допущение, что они равномерно распределятся по году, небезопасно.\n\nПрактические привычки. Держите опись всех сторонних API, которые вызывает продукт, и версий, которые вызываются: нельзя оценить уведомление об отключении для зависимости, о существовании которой вы не знали. Регистрируйте интеграции на общий адрес, а не на человека. Заносите дату отключения в тот же бэклог, что и собственную дорожную карту, в день объявления, а не за месяц до срока. И считайте обязательство о долгой поддержке отсутствующим, пока оно не записано в договоре: публичная политика устаревания — это заявление о намерениях, которое можно пересмотреть, а не гарантия.","Устаревание API — поставщик назначает дату, когда эндпоинт или версия перестанут работать: незапланированная работа по чужому сроку.",null,[11,14,17,20],{"slug":12,"name":13},"api-versioning","API Versioning (версионирование API)",{"slug":15,"name":16},"contract-testing","Контрактное тестирование (Contract Testing)",{"slug":18,"name":19},"sdk","Набор средств разработки (SDK)",{"slug":21,"name":22},"semantic-versioning","Семантическое версионирование (SemVer)",[24,28,32,35,38,41,44,47,50,53,56,59],{"slug":25,"category":5,"name":26,"updated_at":27},"app-review","Проверка приложения","2026-09-08T21:32:37+00:00",{"slug":29,"category":5,"name":30,"updated_at":31},"backend-for-frontend","Backend for Frontend (BFF)","2026-09-08T21:32:36+00:00",{"slug":33,"category":5,"name":34,"updated_at":27},"bulk-api","Массовый API",{"slug":36,"category":5,"name":37,"updated_at":31},"concurrency-limit","Лимит параллельных запросов",{"slug":39,"category":5,"name":40,"updated_at":27},"connector-versioning","Версионирование коннекторов",{"slug":42,"category":5,"name":43,"updated_at":27},"delete-propagation","Распространение удалений",{"slug":45,"category":5,"name":46,"updated_at":27},"effective-permissions","Действующие права",{"slug":48,"category":5,"name":49,"updated_at":31},"event-ordering","Порядок событий",{"slug":51,"category":5,"name":52,"updated_at":31},"field-mapping","Сопоставление полей (field mapping)",{"slug":54,"category":5,"name":55,"updated_at":31},"function-schema","Схема функции",{"slug":57,"category":5,"name":58,"updated_at":31},"grpc","gRPC",{"slug":60,"category":5,"name":61,"updated_at":31},"integration-marketplace","Каталог интеграций (integration marketplace)"]