Версии и даты отключения API: почему интеграция живёт не вечно и что я вношу в календарь

На неделе сразу несколько провайдеров напомнили, что интеграция с чужим API живёт столько, сколько провайдер держит старую версию. Weaviate назвал дату отключения GraphQL, Meta через HighLevel объявила, что маркетинговые сообщения WhatsApp через Cloud API закончатся в октябре 2027 года, Twilio выпустил API настройки вебхуков, Shopify превратил Hydrogen в библиотеку. Владельцу бизнеса это важно: заявки с сайта и сообщения клиентам ходят через такие связки, и когда провайдер отключает версию, они перестают приходить без предупреждения в вашей CRM.

Что вышло

n8n 22 октября разложил, как провайдеры версионируют API: в пути URL вроде /v1/products, в HTTP-заголовке, датой выпуска или параметром запроса. Для интеграции важно знать, где версия указана и как заметить её закат. Заголовок deprecation говорит, что версия выводится из эксплуатации, заголовок sunset даёт точную дату, а после неё провайдер может отвечать 410 Gone.

Weaviate 26 октября объявил, что GraphQL, его первый API запросов, выводится из эксплуатации. В этот день ничего не ломается. Кластеры Weaviate Cloud, которые не использовали GraphQL последние 30 дней, отключат 1 декабря 2026 года, остальные 1 мая 2027 года. Новые кластеры уже создаются без него. Если приложение ходит через текущие клиенты Python, TypeScript, Java или C#, оно, скорее всего, не затронуто: они работают через gRPC. План миграции в четыре шага: найти вызовы /v1/graphql в коде и прокси, выбрать замену, перевести запросы, проверить приложение с выключенным GraphQL.

Twilio 15 октября перевёл в общую доступность Webhook Configuration API: через него вы задаёте, как Twilio подписывает и доставляет исходящие вебхуки, отдельно для каждого URL, двумя ресурсами, Webhook Settings и Webhook Rules. В записи changelog только это, подробности я не смотрел.

HighLevel 19 октября передал решение Meta: с 13 октября 2027 года маркетинговые сообщения WhatsApp перестанут доставляться через Cloud API, их нужно отправлять через Marketing Messages API, который в HighLevel называется MM Lite. Сервисные и утилитарные сообщения остаются на Cloud API. Активация занимает несколько минут на суб-аккаунт, шаблоны и номера HighLevel переносит как есть. HighLevel ссылается на A/B-тест Meta на более чем 12 миллионах сообщений: до +9 % доставки для сообщений с высокой вовлечённостью. Эту цифру я проверить не могу, она из текста Meta в пересказе HighLevel.

Shopify 14 октября выпустил Hydrogen 2026-10. Раньше это был фреймворк на React Router, и чтобы взять его корзину или аналитику, витрину надо было строить на нём целиком. Теперь это библиотека для любого JavaScript-фреймворка: корзина, цены в валюте покупателя, Shop Pay и вход покупателя. Старые витрины продолжают работать. С июня, когда началось превью, вышло семь релизов.

Зачем это бизнесу

Возьмём сервисную компанию. Заявки с сайта уходят в CRM, оттуда клиенту идёт WhatsApp с подтверждением, а по телефонии звонок создаёт лид. Три провайдера, три версии API. Письмо о закате версии приходит на почту подрядчика, который делал интеграцию два года назад и давно занят другим. В дату отключения заявки перестают доходить, и первым это замечает продавец, у которого вторник прошёл без лидов.

Вывод: у каждой интеграции есть владелец, версия и дата, до которой она точно работает. Если хотя бы одного из трёх нет, дата её конца неизвестна, и узнаете вы её по факту.

Как это устроено у меня

У PDR-компании в США я с 2021 года веду связку сервера, телефонии, парсеров и CRM. В 2022 году я написал интеграцию приложения продавцов на AppSheet с GoHighLevel, а весь 2023 год её дорабатывал, пока компания переходила с Google Таблиц на MariaDB и подключала новые сервисы один за другим. Внутренний API за эти годы я довёл до третьей версии, так что смену версий знаю с обеих сторон: как потребитель чужого API и как автор своего. В стеке там Twilio и GoHighLevel, так что оба changelog из этого обзора мне есть куда примерить, и календарь отключений у меня часть сопровождения.

У компании по аренде автомобилей в ЮАР с октября 2024 по февраль 2025 года я настраивал синхронизацию полей между приложением на FlutterFlow с бэкендом Firebase и AmoCRM, и эта связка тоже живёт на версии чужого API.

Что я бы сделал

Составить список интеграций: провайдер, версия, где она указана, кто получает письма от провайдера. На это уходит час, и он окупается первым же отключением.

Логировать заголовки deprecation и sunset в ответах провайдеров и поднимать уведомление, когда они появляются. Это один middleware на сервере.

Обрабатывать 410 отдельно от обычных ошибок. Повторные попытки здесь только засоряют лог.

Проверять новую версию в отдельной среде до переключения. Weaviate предлагает выключить GraphQL на тестовом кластере и посмотреть, что сломалось.

Внести даты в календарь уже сейчас: 1 декабря 2026 года и 1 мая 2027 года у Weaviate, 13 октября 2027 года у Meta. Для WhatsApp в HighLevel включить MM Lite на самом нагруженном суб-аккаунте и проверить доставку, пока есть год запаса.

Связанные материалы

О том, как не терять данные между документами, CRM и задачами, я писал в статье Как надёжно соединить документы, CRM и задачи. Направления: API-интеграции с понятными правилами передачи данных и CRM, связанная с работой команды. Страницы по теме: собственный API для нескольких приложений и план воронки и коммуникаций в GoHighLevel. Из других обзоров: что в октябрьских изменениях GoHighLevel трогает интеграцию и радиус поражения обновления. Раньше я писал, как проверять контракт API до обновления интеграции и про отключение каталога Shopify. Если у вас есть интеграция, про версию которой никто не помнит, расскажите, какие сервисы связаны и кто их сопровождает. Обсудить задачу.