Устаревание API

Zone Settings Batch API

Дата прекращения поддержки: April 23, 2025

Дата окончания жизненного цикла: 31 марта 2027 г.

Обновление: Дата окончания срока действия этого устаревшего функционала перенесена на 31 марта 2027 года (ранее было 15 сентября 2026 года).

Конечные точки Zone Settings Batch API, которые позволяют читать и изменять несколько настроек зоны за один запрос, считаются устаревшими и прекратят поддержку 31 марта 2027 года. Вместо них используйте отдельные конечные точки для чтения и изменения настроек зоны по одной.

Устаревшие API:

• GET /zones/{zone_id}/settings
• PATCH /zones/{zone_id}/settings

Замены:

• Get zone setting, GET /zones/{zone_id}/settings/{setting_id}
• Изменение настройки зоны, PATCH /zones/{zone_id}/settings/{setting_id}

Интеграциям, которые считывают или изменяют несколько настроек за один вызов, необходимо перейти на запросы для отдельных настроек до 31 марта 2027 года, чтобы обеспечить бесперебойную работу сервиса. После этой даты пакетные конечные точки будут недоступны.

Логическая настройка Foundation DNS

Дата прекращения поддержки: July 27, 2026

Дата окончания жизненного цикла: 23 ноября 2026 г.

foundation_dns логическое значение является устаревшим в Конечные точки настроек DNS для настроек зоны и значений по умолчанию для учетной записи. Используйте nameservers.type: "cloudflare.advanced" чтобы вместо этого настроить Advanced Nameservers.

Затронутые эндпоинты:

• /zones/{zone_id}/dns_settings
• /accounts/{account_id}/dns_settings

Начиная с 26 октября 2026 года API настроек DNS будет постепенно представлять Advanced Nameservers в виде nameservers.type: "cloudflare.advanced". Ожидается, что развёртывание займёт семь дней. Пока развёртывание не дойдёт до аккаунта, API будет продолжать возвращать nameservers.type: "cloudflare.standard" для расширенных серверов имён. API будет принимать nameservers.type: "cloudflare.advanced" в PATCH запросы для учетных записей с необходимыми правами на протяжении всего развертывания.

foundation_dns логическое значение остаётся доступным как псевдоним для обратной совместимости на время переходного периода. Вы можете продолжать читать и записывать его. Если PATCH запрос включает оба значения, они должны совпадать. API отклонит несовпадающие значения.

Начиная с 23 ноября 2026 года API настроек DNS больше не будет возвращать или принимать foundation_dns. Ожидается, что развёртывание займёт семь дней. PATCH запросов, содержащих foundation_dns будут отклонены. Обновите клиентов, которые обрабатывают nameservers.type как закрытое перечисление (enum) для распознавания "cloudflare.advanced" значение и обновите клиентов, которые читают или записывают foundation_dns до даты завершения поддержки. Это изменение API не влияет ни на вашу подписку Foundation DNS, ни на то, включены ли Advanced Nameservers для ваших зон. Миграция зоны не требуется.

Ограничение имени аккаунта в 65 символов

Дата вступления в силу: 27 сентября 2026 г.

Имя аккаунта будет ограничено 65 символами во всех API создания и обновления аккаунтов. Это ограничение действует для всех аккаунтов, включая аккаунты организаций. В настоящее время API обновления аккаунта (PUT /accounts/{account_id}) уже применяет это ограничение, тогда как API создания аккаунта (POST /accounts) незаметно обрезает имена длиной до 120 байт. Из-за этого несоответствия аккаунт может быть успешно создан, но его нельзя будет впоследствии переименовать. После September 27, 2026 API создания будет отклонять имена длиннее 65 символов с кодом HTTP 400 ошибка.

Затронутые API:

• POST /accounts : Создание учётной записи
• PUT /accounts/{account_id} : обновление аккаунта (уже применяется)

После даты вступления требования в силу интеграции, создающие учётные записи с именами длиннее 65 символов, должны обрезать или сокращать имя перед отправкой запроса, чтобы обеспечить бесперебойную работу сервиса.

Account Roles API

Дата прекращения поддержки: July 21, 2026

Account Roles API на данный момент возвращает только роли уровня аккаунта и считается устаревшим в пользу Permission Groups API. Permission Groups API является поддерживаемым способом перечисления ролей уровня аккаунта, зоны и ресурса, которые можно предоставить участникам аккаунта.

Устаревшие API:

• GET /accounts/{account_id}/roles : Список ролей
• GET /accounts/{account_id}/roles/{role_id} : Сведения о роли

Замены:

• GET /accounts/{account_id}/iam/permission_groups : Список групп разрешений учётной записи
• GET /accounts/{account_id}/iam/permission_groups/{permission_group_id} : Сведения о группе разрешений

Схема ответа отличается от прежнего ответа Roles:

• Устаревший Role ответ включает на верхнем уровне description и permissions объект с ключами по типу ресурса и флагами редактирования/чтения.
• PermissionGroup ответ заменяет их на meta объект, содержащий label и scopes. Отдельные права не возвращаются в составе группы прав.

Дополнительные примечания:

• Интеграциям, переходящим на Permission Groups API, необходимо получать Permission Group IDs через этот API и использовать их в структуре запросов policies в Account Members API. Интеграциям, которые продолжают хранить устаревшие Role IDs, потребуется переназначить свои назначения.
• Обе конечные точки используют стандартную обёртку ответа Cloudflare, поэтому пагинация и обработка ошибок не меняются.
• Новый API поддерживает API-токен схема авторизации. Устаревшая схема авторизации Email + API Key сохранена для обратной совместимости.
• Затронутым ресурсом terraform является cloudflare_account_role источник данных. Вам нужно будет перейти на cloudflare_account_permission_group источник данных.

Workers KV: Legacy Namespace Routes

Дата прекращения поддержки: July 15, 2026

Дата окончания жизненного цикла: 15 октября 2026 г.

Прежние маршруты API Workers KV, начинающиеся с /accounts/{account_id}/workers/namespaces/* признаны устаревшими в пользу Workers KV API маршрутов в /accounts/{account_id}/storage/kv/namespaces/*.

Прежние и новые маршруты взаимозаменяемы. Они принимают одинаковые параметры запроса и возвращают одинаковые данные в ответе. Для перехода измените путь URL с /workers/namespaces/ к /storage/kv/namespaces/.

Устаревшие API:

• GET и POST /accounts/{account_id}/workers/namespaces (просмотр списка и создание пространств имён)
• GET, PUT, а также DELETE /accounts/{account_id}/workers/namespaces/{namespace_id} (получение, переименование и удаление пространства имён)
• GET /accounts/{account_id}/workers/namespaces/{namespace_id}/keys (просмотр списка ключей)
• GET /accounts/{account_id}/workers/namespaces/{namespace_id}/metadata/{key_name} (чтение метаданных ключа)
• GET, PUT, а также DELETE /accounts/{account_id}/workers/namespaces/{namespace_id}/values/{key_name} (чтение, запись и удаление пар ключ-значение)

Замены:

Измените путь URL с /workers/namespaces/ к /storage/kv/namespaces/ в каждой конечной точке.

• GET и POST /accounts/{account_id}/storage/kv/namespaces (просмотр списка и создание пространств имён)
• GET, PUT, а также DELETE /accounts/{account_id}/storage/kv/namespaces/{namespace_id} (получение, переименование и удаление пространства имён)
• GET /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/keys (просмотр списка ключей)
• GET /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/metadata/{key_name} (чтение метаданных ключа)
• GET, PUT, а также DELETE /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key_name} (чтение, запись и удаление пар ключ-значение)

После 15 октября 2026 года запросы к устаревшему /accounts/{account_id}/workers/namespaces/* маршруты больше не будут поддерживаться. Обновите интеграции для использования задокументированных конечных точек Workers KV API до этой даты, чтобы обеспечить бесперебойную работу службы.

Zero Trust Networks Route Endpoints and Cloudflare Tunnel Connections Field

Дата прекращения поддержки: July 9, 2026

Дата окончания жизненного цикла: 5 октября 2026 г.

Два связанных изменения в Zero Trust Networks API и Cloudflare Tunnel API вступят в силу 5 октября 2026 года.

Конечные точки маршрутов

Конечные точки маршрутов в формате CIDR считаются устаревшими; вместо них рекомендуется использовать стандартные, route_id-based эндпоинтов, которые уже существуют на сегодняшний день.

Устаревшие API:

• POST /accounts/{account_id}/teamnet/routes/network/{ip_network_encoded}
• PATCH /accounts/{account_id}/teamnet/routes/network/{ip_network_encoded}
• DELETE /accounts/{account_id}/teamnet/routes/network/{ip_network_encoded}

Замены:

• POST /accounts/{account_id}/teamnet/routes
• PATCH /accounts/{account_id}/teamnet/routes/{route_id}
• DELETE /accounts/{account_id}/teamnet/routes/{route_id}

Подключения Cloudflare Tunnel и Cloudflare Mesh

connections массив удален из ответов операций list и get для узлов Cloudflare Tunnel и Cloudflare Mesh ( cfd_tunnel и warp_connector API resources). Вместо чтения этого поля из объекта туннеля или узла запрашивайте выделенный эндпоинт connections.

Затронутые API:

• GET /accounts/{account_id}/cfd_tunnel
• GET /accounts/{account_id}/cfd_tunnel/{tunnel_id}
• GET /accounts/{account_id}/warp_connector
• GET /accounts/{account_id}/warp_connector/{tunnel_id}

Замены:

• GET /accounts/{account_id}/cfd_tunnel/{tunnel_id}/connections
• GET /accounts/{account_id}/warp_connector/{tunnel_id}/connections

Полное руководство по миграции, включая curl примеры и cloudflared и примечания по Terraform см. в Журнал изменений Cloudflare Tunnel.

AMP/SXG API and Rules

Дата прекращения поддержки: September 18, 2025

Дата окончания жизненного цикла: 23 июня 2026 г.

Функции AMP/SXG достигли конца жизненного цикла. Замены этой функциональности не будет. Конечные точки API настроек зоны и sxg Настройка Configuration Rule больше не следует использовать.

Устаревшие API:

• GET /zones/{zone_id}/amp/sxg
• PUT /zones/{zone_id}/amp/sxg

Устаревшая настройка Configuration Rule:

• sxg

Интерфейс панели управления больше не будет содержать упоминаний AMP или настройки sxg. Пользователи могут удалить параметр sxg из своих наборов правил, используя Rulesets API. Прекращение поддержки в Terraform последует позже, и пользователям следует удалить ссылки на sxg параметр из их terraform.

Устаревший Registrar Domain Management API

Дата прекращения поддержки: April 10, 2026

Дата окончания жизненного цикла: 27 сентября 2026 г.

Прежние конечные точки управления доменами Registrar являются устаревшими и будут выведены из эксплуатации September 27, 2026. Они заменены новыми Registrar API, который предоставляет возможности поиска доменов, проверки их доступности и регистрации.

Устаревшие API:

• GET /accounts/{account_id}/registrar/domains : Список доменов
• GET /accounts/{account_id}/registrar/domains/{domain_name} : Получение домена
• PUT /accounts/{account_id}/registrar/domains/{domain_name} : обновление домена

Замена: Registrar API

• Поиск доступных доменов, GET /accounts/{account_id}/registrar/domain-search
• Проверка доступности домена, POST /accounts/{account_id}/registrar/domain-check
• Список регистраций, GET /accounts/{account_id}/registrar/registrations
• Создание регистрации, POST /accounts/{account_id}/registrar/registrations

Клиентам и интеграциям, использующим устаревшие эндпоинты управления доменами, необходимо перейти на новый Registrar API до 27 сентября 2026 года, чтобы обеспечить бесперебойную работу сервиса. После этой даты устаревшие эндпоинты будут недоступны.

Правила аудита SSH в Gateway

Дата прекращения поддержки: November 3, 2025

Дата окончания жизненного цикла: 15 июля 2026 г.

Действие Gateway Audit SSH для сетевые политики устарел и будет полностью удалён 15 июля 2026 года. SSH с Access for Infrastructure заменяет собой средства для управления и аудита доступа по SSH.

Создание новых правил Gateway с помощью action: "audit_ssh" через панель управления была отключена в декабре 2024 года. Создание новых правил через API и Terraform было отключено 3 ноября 2025 года. Редактирование существующих правил через панель управления, API и Terraform было отключено 15 января 2026 года. 15 июля 2026 года все оставшиеся правила Audit SSH прекратят работу.

Устаревшие API:

• POST /accounts/{account_id}/gateway/rules : создание правил с action: "audit_ssh" больше не принимается
• PUT /accounts/{account_id}/gateway/rules/{rule_id} : редактирование правил с action: "audit_ssh" больше не принимается

Замена: SSH с Access for Infrastructure

Аутентификация Service Key

Дата прекращения поддержки: March 19, 2026

Дата окончания жизненного цикла: 30 сентября 2026 г.

Аутентификация Service Key для Cloudflare API объявлена устаревшей и будет удалена 30 сентября 2026 года. API-токены обеспечивают весь функционал Service Keys, а также дополнительно поддерживают точную настройку прав доступа, срок действия и ограничения по IP-адресам.

Устаревшее поведение:

• Аутентификация запросов к API с помощью X-Auth-User-Service-Key заголовок.
• Создание новых Service Keys через панель управления Cloudflare или API. Возможность создавать новые Service Keys из панели управления скоро будет удалена.

Замена:

• Создание API-токена с разрешениями, соответствующими вашему сценарию использования. API Tokens поддерживают точную настройку области действия, срок действия и возможность отзыва.

Пользователи cloudflared должны убедиться, что используют версию от ноября 2022 года или новее, в которой применяются API Tokens вместо Service Keys. Пользователи origin-ca-issuer следует обновиться до версии, поддерживающей аутентификацию через API Token.

Обновления типов DNS-записей через API

Дата прекращения поддержки: January 23, 2026

Дата окончания жизненного цикла: 30 июня 2026 г.

Изменение типа существующей DNS-записи через API является устаревшей возможностью и перестанет поддерживаться после 30 июня 2026 года.

Изменение типа DNS-записи не является обычной операцией обновления и, как правило, также требует изменения содержимого записи. Обновление таких атрибутов, как имя, TTL или содержимое, является распространенной и безопасной операцией, однако изменение типа записи усложняет проверку и создает риски для согласованности данных.

Чтобы соответствовать корректной семантике DNS и снизить операционные риски, Cloudflare прекращает поддержку изменения типа DNS записи на месте. Такое поведение уже действует в провайдере Terraform v5: при изменении типа записи выполняется удаление и создание заново, а не обновление.

Устаревшее поведение:

• С помощью DNS Records API чтобы изменить тип существующей записи.

Поведение при замене:

• Удалите существующую DNS-запись и Создание новой DNS-записи с нужным типом и содержимым.

  DELETE /zones/{zone_id}/dns_records/{dns_record_id}

  POST /zones/{zone_id}/dns_records

• Используйте Пакетная обработка DNS-записей API, чтобы выполнить обе операции в одном запросе.

  POST /zones/{zone_id}/dns_records/batch

Клиентам и интеграциям, использующим обновление типа записи на месте, необходимо перейти на подход с удалением и повторным созданием записи до 30 июня 2026 года, чтобы обеспечить бесперебойную работу сервиса. После этой даты изменение типа записи через операции обновления больше не будет поддерживаться.

Устаревшая аналитика Authoritative DNS и DNS Firewall

Дата прекращения поддержки: December 9, 2025

Дата окончания жизненного цикла: 1 декабря 2026 г.

Указанные ниже REST API являются устаревшими и будут выведены из эксплуатации December 1, 2026.

• DNS Analytics API
• DNS Firewall Analytics API

Вся существующая функциональность полностью поддерживается в GraphQL Analytics API от Cloudflare, который обеспечивает более высокую производительность, гибкость и долгосрочную поддержку. Интеграции, использующие REST API, необходимо перевести на новый GraphQL API до 1 декабря 2026 года, чтобы обеспечить бесперебойную работу сервиса.

Устаревшие API:

• GET/zones/{zone_id}/dns_analytics/ (DNS Analytics API)
• GET/accounts/{account_id}/dns_firewall/{dns_firewall_id}/dns_analytics/report (DNS Firewall Analytics API)

Замены:

• GraphQL API для DNS Analytics
• GraphQL API для DNS Firewall Analytics

Zero Trust Devices

Дата окончания жизненного цикла: 11 ноября 2025 г.

Мы меняем определение термина Devices. Отныне Devices будут обозначать реальные физические устройства, а связь между Users и Devices будет описываться новым понятием Registrations.

В результате несколько полей переносятся из Devices в Registrations, и мы прекращаем поддержку эндпоинтов, перечисленных ниже.

Устаревшие конечные точки не поддерживаются на аккаунтах с многопользовательский режим включено.

Устаревший API:

• GET /accounts/{account_id}/devices
• GET /accounts/{account_id}/devices/{device_id}
• GET /accounts/{account_id}/devices/{device_id}/override_codes
• POST /accounts/{account_id}/devices/revoke
• POST /accounts/{account_id}/devices/unrevoke

Замена:

• GET /accounts/{account_id}/devices/physical-devices
• GET /accounts/{account_id}/devices/physical-devices/{device_id}
• GET /accounts/{account_id}/devices/registrations
• GET /accounts/{account_id}/devices/registrations/{registration_id}
• GET /accounts/{account_id}/devices/registrations/{registration_id}/override_codes
• POST /accounts/{account_id}/devices/registrations/revoke
• POST /accounts/{account_id}/devices/registrations/unrevoke

Cloudflare Mirage

Дата прекращения поддержки: November 2025

Дата окончания жизненного цикла: январь 2026 г.

В продолжение прекращение поддержки Cloudflare Mirage, следующие API-эндпоинты для управления настройками Mirage теперь устарели и будут отключены в January 2026.

Устаревшие API:

• GET /zones/{zone_id}/settings/mirage
• PATCH /zones/{zone_id}/settings/mirage

Затронутые API:

• GET /zones/{zone_id}/pagerules/settings - Mirage будет удалён из доступных настроек.
• POST /zones/{zone_id}/pagerules - параметр Mirage будет удалён.
• PATCH /zones/{zone_id}/pagerules/{rule_id} - параметр Mirage будет удалён.
• PUT /zones/{zone_id}/pagerules/{rule_id} - параметр Mirage будет удалён.
• GET /zones/{zone_id}/rulesets/{ruleset_id} - параметр Mirage в set_config действие будет удалено.
• GET /zones/{zone_id}/rulesets/{ruleset_id}/versions/{version_id} - параметр Mirage в set_config действие будет удалено.
• POST /zones/{zone_id}/rulesets - параметр Mirage в set_config действие будет удалено.
• PUT /zones/{zone_id}/rulesets/{ruleset_id} - параметр Mirage в set_config действие будет удалено.
• POST /zones/{zone_id}/rulesets/{ruleset_id}/rules - параметр Mirage в set_config действие будет удалено.
• PATCH /zones/{zone_id}/rulesets/{ruleset_id}/rules/{rule_id} - параметр Mirage в set_config действие будет удалено.
• GET /accounts/{account_id}/rulesets/{ruleset_id} - параметр Mirage в set_config действие будет удалено.
• GET /accounts/{account_id}/rulesets/{ruleset_id}/versions/{version_id} - параметр Mirage в set_config действие будет удалено.
• POST /accounts/{account_id}/rulesets - параметр Mirage в set_config действие будет удалено.
• PUT /accounts/{account_id}/rulesets/{ruleset_id} - параметр Mirage в set_config действие будет удалено.
• POST /accounts/{account_id}/rulesets/{ruleset_id}/rules - параметр Mirage в set_config действие будет удалено.
• PATCH /accounts/{account_id}/rulesets/{ruleset_id}/rules/{rule_id} - параметр Mirage в set_config действие будет удалено.

Cloudflare Radar: эндпоинты групп Summary и Timeseries

Дата прекращения поддержки: October 15, 2025

Дата окончания жизненного цикла: 15 апреля 2026 г.

В настоящее время Radar API содержит несколько конечных точек для сводных данных и групп временных рядов для каждого набора данных (например, /radar/http/summary/device_type и /radar/http/timeseries_groups/device_type), которые имеют почти идентичные параметры и схему. Чтобы упростить API и облегчить его поддержку, эти конечные точки будут заменены параметризованными конечными точками с использованием {dimension} параметр пути.

Устаревшие API:

• GET /radar/http/summary/device_type
• GET /radar/http/summary/bot_class
• GET /radar/http/timeseries_groups/device_type
• GET /radar/http/timeseries_groups/bot_class
• Похожие эндпоинты сводных данных и временных рядов доступны для следующих наборов данных: AI Bots, AI Inference, AS112, DNS, Email Routing, Email security, HTTP, Layer 3 Attacks, Layer 7 Attacks, Leaked Credential Checks

Замены:

• GET /radar/http/summary/{dimension}
• GET /radar/http/timeseries_groups/{dimension}
• ...

Здесь {dimension} это обязательный параметр пути, перечисляющий все доступные измерения для набора данных.

Если вы обращаетесь к API напрямую, а не через Cloudflare SDK, никаких действий не требуется. Если вы используете SDK, рекомендуем перейти на новые операции, чтобы сохранить совместимость после удаления старых.

Cloudflare Radar: API Verified Bots

Дата прекращения поддержки: July 1, 2025

Дата окончания жизненного цикла: 1 января 2026 г.

Radar Verified Bots API признан устаревшим и будет заменён новым Bots API.

Устаревшие API:

• GET /radar/verified_bots/top/bots
• GET /radar/verified_bots/top/categories

Замены:

• GET /radar/bots/summary/bot
• GET /radar/bots/summary/category

Cloudflare DWeb Resolver

Дата прекращения поддержки: July 1, 2025

Экспериментальная функция Cloudflare DWeb Resolver прекращает работу.

Устаревшие API:

• DoH-резолвер на resolver.cloudflare-eth.com

Firewall Rules API и Filters API

Дата прекращения поддержки: June 15, 2025

API Firewall Rules и API Filters считаются устаревшими, так как Firewall Rules были признаны устаревшими в пользу Пользовательские правила WAF. См. Обновление Firewall Rules для получения дополнительной информации об этом изменении.

Устаревшие API:

• GET /zones/:zone_id/firewall/rules
• POST /zones/:zone_id/firewall/rules
• PATCH /zones/:zone_id/firewall/rules
• PUT /zones/:zone_id/firewall/rules
• DELETE /zones/:zone_id/firewall/rules
• GET /zones/:zone_id/firewall/rules/:rule_id
• PATCH /zones/:zone_id/firewall/rules/:rule_id
• PUT /zones/:zone_id/firewall/rules/:rule_id
• DELETE /zones/:zone_id/firewall/rules/:rule_id
• GET /zones/:zone_id/filters
• POST /zones/:zone_id/filters
• PUT /zones/:zone_id/filters
• DELETE /zones/:zone_id/filters
• GET /zones/:zone_id/filters/:filter_id
• PUT /zones/:zone_id/filters/:filter_id
• DELETE /zones/:zone_id/filters/:filter_id

Замена: Пользовательские правила WAF

API WAF managed rules (предыдущая версия)

Дата прекращения поддержки: June 15, 2025

API для управления управляемыми правилами WAF (предыдущая версия), а именно для управления пакетами, группами правил, правилами и переопределениями, считаются устаревшими; вместо них следует использовать Rulesets API для управления новой версией WAF Managed Rules. См. Обновление WAF Managed Rules для получения дополнительной информации об этом изменении.

Устаревшие API:

• GET /zones/:zone_id/firewall/waf/packages
• GET /zones/:zone_id/firewall/waf/packages/:package_id
• PATCH /zones/:zone_id/firewall/waf/packages/:package_id
• GET /zones/:zone_id/firewall/waf/packages/:package_id/groups
• GET /zones/:zone_id/firewall/waf/packages/:package_id/groups/:group_id
• PATCH /zones/:zone_id/firewall/waf/packages/:package_id/groups/:group_id
• GET /zones/:zone_id/firewall/waf/packages/:package_id/rules
• GET /zones/:zone_id/firewall/waf/packages/:package_id/rules/:rule_id
• PATCH /zones/:zone_id/firewall/waf/packages/:package_id/rules/:rule_id
• GET /zones/:zone_id/firewall/waf/overrides
• POST /zones/:zone_id/firewall/waf/overrides
• GET /zones/:zone_id/firewall/waf/overrides/:override_id
• PUT /zones/:zone_id/firewall/waf/overrides/:override_id
• DELETE /zones/:zone_id/firewall/waf/overrides/:override_id

Замена: WAF Managed Rules (новая версия)

Rate Limiting API (предыдущая версия)

Дата прекращения поддержки: June 15, 2025

Rate Limiting API считается устаревшим; вместо него рекомендуется использовать Rulesets API для управления новым правила ограничения частоты запросов. См. Переход с Rate Limiting (предыдущая версия) для получения дополнительной информации об этом изменении.

Устаревший API:

• GET /zones/:zone_id/rate_limits
• POST /zones/:zone_id/rate_limits
• GET /zones/:zone_id/rate_limits/:rate_limit_id
• PUT /zones/:zone_id/rate_limits/:rate_limit_id
• DELETE /zones/:zone_id/rate_limits/:rate_limit_id

Замена: Правила ограничения скорости (новая версия)

Zone Setting: cname_flattening

Дата прекращения поддержки: June 8, 2025

Конечные точки Zone Settings API для управления выравниванием CNAME на уровне зоны считаются устаревшими. Вместо них используйте Показать настройки DNS и Обновление настроек DNS конечные точки, чтобы управлять этой настройкой.

Изменения через старые конечные точки будут отражаться в новых и наоборот, поэтому переносить существующие зоны не требуется. Однако в дальнейшем API-запросы должны использовать DNS Settings вместо конечных точек Zone Settings.

Обратите внимание, что при использовании устаревшей настройки зоны значения "off" и "apex" ведут себя одинаково. Они представлены как {"flatten_all_cnames": false} в новом API. Настройка зоны "on" соответствует {"flatten_all_cnames": true} в новом API.

Затронутые API:

• GET /zones/:zone_id/settings
• PATCH /zones/:zone_id/settings

Устаревшие API:

• GET /zones/:zone_id/settings/cname_flattening
• PATCH /zones/:zone_id/settings/cname_flattening

Eligible Zones For Account Custom Nameservers

Дата прекращения поддержки: March 23, 2025

Теперь пользователи могут добавлять собственные серверы имён, не входящие в зону, управляемую в их аккаунте. Благодаря этому собственные серверы имён доступны для любой зоны независимо от того, управляется ли она Cloudflare. В связи с этим изменением конечная точка для проверки зон, подходящих для этой функции, утратила актуальность и поэтому упраздняется.

Устаревшие API:

• GET /accounts/:account_id/custom_ns/availability

Cloudflare Radar: эндпоинты по основным отраслям и направлениям атак

Дата прекращения поддержки: March 20, 2025

Дата окончания жизненного цикла: 20 сентября 2025 г.

/top/industry и /top/vertical конечные точки attack теперь устарели и будут заменены соответствующими конечными точками summary.

Затронутые API:

• GET /radar/attacks/layer3/top/industry
• GET /radar/attacks/layer3/top/vertical
• GET /radar/attacks/layer7/top/industry
• GET /radar/attacks/layer7/top/vertical

Замены:

• GET /radar/attacks/layer3/summary/industry
• GET /radar/attacks/layer3/summary/vertical
• GET /radar/attacks/layer7/summary/industry
• GET /radar/attacks/layer7/summary/vertical

Security Center: уровень безопасности и Threat Score теперь настраиваются автоматически

Дата изменения: March 17, 2025

Cloudflare теперь объединяет сигнал угрозы по IP-адресу с данными о пороговых значениях и ботнетах, поэтому вам больше не нужно устанавливать уровень чувствительности. Пользователи больше не смогут задавать Security level через панель управления Cloudflare. Однако пользователи по прежнему могут использовать существующий API или конфигурацию Terraform, чтобы задать Security level.

Если вы используете оценку угрозы в выражениях правил, проверьте эти выражения, чтобы правило по-прежнему срабатывало, когда это нужно. В дальнейшем Cloudflare проверит и обновит вашу конфигурацию, заменив все ссылки на оценку угрозы. Если вы применяете Rulesets API или Terraform для настройки конфигурации, проверьте свои скрипты и конвейеры до конца Q1 2026, чтобы избежать проблем.

Account Settings: default_nameservers and use_account_custom_ns_by_default

Дата прекращения поддержки: March 14, 2025

Поля "default_nameservers" и "use_account_custom_ns_by_default" в пределах "settings" объект accounts считается устаревшим. Вместо него используйте Показать настройки DNS и Обновление настроек DNS конечные точки, чтобы управлять этой настройкой. В новом API эта настройка доступна как .zone_defaults.nameservers.type, с допустимыми значениями "cloudflare.standard", "cloudflare.standard.random", "custom.account" и "custom.tenant".

Изменения через старые конечные точки будут отражаться в новых и наоборот, поэтому переносить существующие зоны не требуется. Однако в дальнейшем API-запросы должны использовать DNS Settings вместо конечных точек Accounts.

Затронутые API:

• GET /accounts
• POST /accounts
• GET /accounts/:account_id
• PUT /accounts/:account_id

Cloudflare Radar: параметр силы атаки уровня L7

Дата прекращения поддержки: March 11, 2025

Дата окончания жизненного цикла: 11 июня 2025 г.

Атака на 7-м уровне magnitude параметр запроса, который позволяет определить масштаб атаки по общему количеству заблокированных запросов (MITIGATED_REQUESTS) или общее количество атакованных зон (AFFECTED_ZONES), считается устаревшим. Впредь Cloudflare Radar будет определять величину атак 7 уровня только на основе общего количества заблокированных запросов.

Затронутый API:

GET /radar/attacks/layer7/top/attacks

Замена:

Пользователям следует прекратить использование magnitude параметр, так как поведение по умолчанию уже использует MITIGATED_REQUESTS.

DNS Records API: изменения в параметрах фильтрации

Дата прекращения поддержки: February 21, 2025

Следующие параметры URL для фильтрации DNS-записей считаются устаревшими:

• name=contains:value Вместо этого используйте поддерживаемый name.contains=value синтаксис.
• name=starts_with:value Вместо этого используйте поддерживаемый name.startswith=value синтаксис.
• name=ends_with:value Вместо этого используйте поддерживаемый name.endswith=value синтаксис.
• name=one,two,three (поиск по одному из нескольких возможных имён, перечисленных через запятую) Вместо этого отправляйте несколько запросов, по одному для каждого возможного name. В качестве альтернативы, если выполняется запрос только к name поле, ?match=any&name=one&name=two&name=three синтаксис можно использовать вместо этого. У этого синтаксиса продленная дата прекращения поддержки: 23 мая 2025 года.
• content=contains:value Вместо этого используйте поддерживаемый content.contains=value синтаксис.
• content=starts_with:value Вместо этого используйте поддерживаемый content.startswith=value синтаксис.
• content=ends_with:value Вместо этого используйте поддерживаемый content.endswith=value синтаксис.
• content=one,two,three (поиск по одному из нескольких возможных значений содержимого, перечисленных через запятую) Вместо этого отправляйте несколько запросов, по одному для каждого возможного content. В качестве альтернативы, если выполняется запрос только к content поле, ?match=any&content=one&content=two&content=three синтаксис можно использовать вместо этого. У этого синтаксиса продленная дата прекращения поддержки: 23 мая 2025 года.
• type=contains:value Поиск по подстрокам имени типа больше не будет поддерживаться. Вместо этого выполняйте поиск по точному имени типа, например type=CNAME. Если входное значение представляет собой произвольный текстовый запрос от пользователя, рассмотрите возможность использования search параметр вместо этого.

Ни один из устаревающих параметров никогда официально не поддерживался согласно нашей документации по API.

Затронутые API:

• GET /zones/:zone_id/dns_records

Access-приложения: self_hosted_domains

Дата прекращения поддержки: November 21, 2025

self_hosted_domains поле для Приложения Access устарел в пользу destinations чтобы обеспечить больше гибкости при определении разных типов доменов.

До:

{
  // ...
  "self_hosted_domains": ["foo.example.com", "bar.example.com"]
}

После:

{
  // ...
  "destinations": [
    {
      "type": "public",
      "uri": "foo.example.com"
    },
    {
      "type": "public",
      "uri": "bar.example.com"
    }
  ]
}

API будет принимать оба поля до даты прекращения поддержки. Если self_hosted_domains указаны, они будут интерпретированы как public назначения. Однако если destinations указаны, то self_hosted_domains будет игнорироваться, даже если указано.

Кроме того, API продолжит возвращать self_hosted_domains до даты прекращения поддержки. Поле будет содержать URI подмножества назначений, имеющих тип public.

Затронутые API:

• GET /accounts/:account_id/access/apps
• POST /accounts/:account_id/access/apps
• GET /accounts/:account_id/access/apps/:app_id
• PUT /accounts/:account_id/access/apps/:app_id
• GET /zones/:zone_id/access/apps
• POST /zones/:zone_id/access/apps
• GET /zones/:zone_id/access/apps/:app_id
• PUT /zones/:zone_id/access/apps/:app_id

Информация о зоне в отдельных записях DNS

Дата прекращения поддержки: November 30, 2024

В настоящее время каждая отдельная DNS-запись, возвращаемая API, содержит информацию о зоне, к которой она относится, а именно ID и имя зоны.

{
  "result": [
    {
      // ...
      "zone_id": "ab922473c42f4e50819d7c1c9b81b16b",
      "zone_name": "example.com"
    }
  ],
  // ...
}

Эта информация избыточна, поскольку оба затронутых маршрута API уже находятся в пределах области действия зоны. В частности, идентификатор зоны уже будет известен любому пользователю этих маршрутов, поскольку он присутствует в URL. Имя зоны можно получить, выполнив GET запрос к /zones/:zone_id если это необходимо.

После 30 ноября 2024 года Cloudflare перестанет включать zone_id и zone_name поля в отдельных DNS-записях в ответах API. В настоящее время эти поля игнорируются при отправке в API в составе тела запроса, поэтому менять тело запроса не требуется.

Измененный API:

• GET /zones/:zone_id/dns_records
• POST /zones/:zone_id/dns_records
• GET /zones/:zone_id/dns_records/:dns_record_id
• PATCH /zones/:zone_id/dns_records/:dns_record_id
• PUT /zones/:zone_id/dns_records/:dns_record_id

DNS Records: цепочки ошибок валидации DNS

Дата прекращения поддержки: October 1, 2024

Cloudflare вносит небольшое изменение в формат отображения некоторых ошибок при создании DNS-записей. Сейчас, если создаваемая DNS-запись некорректна, может возвращаться ошибка примерно такого вида:

{
  "result": null,
  "success": false,
  "errors": [
    {
      "code": 1004,
      "message": "DNS Validation Error",
      "error_chain": [
        {
          "code": 9999,
          "message": "This is an example."
        }
      ]
    }
  ],
  "messages": []
}

После 1 октября 2024 года error_chain будет опущено, и в результате будет возвращена непосредственно первопричина, не обёрнутая в ещё одну ошибку "DNS Validation Error":

{
  "result": null,
  "success": false,
  "errors": [
    {
      "code": 9999,
      "message": "This is an example."
    }
  ],
  "messages": []
}

Устаревшие конечные точки настроек DNS

Дата прекращения поддержки: September 13, 2024

Отдельные конечные точки для настроек DNS use_apex_ns и secondary_overrides признаны устаревшими.

Вместо этого используйте Показать настройки DNS и Обновление настроек DNS конечные точки, чтобы управлять этими настройками.

• Вместо .../use_apex_ns конечную точку, используйте multi_provider поле.
• Вместо .../secondary_overrides конечную точку, используйте secondary_overrides поле.

Устаревшие API:

• GET /zones/:zone_id/dns_settings/use_apex_ns
• PATCH /zones/:zone_id/dns_settings/use_apex_ns
• GET /zones/:zone_id/dns_settings/secondary_overrides
• PATCH /zones/:zone_id/dns_settings/secondary_overrides

Brotli

Дата прекращения поддержки: August 15, 2024

Настройка Brotli и связанные с ней конечные точки API считаются устаревшими. Сжатие Brotli доступно для всех зон, кроме тарифа Enterprise, и в течение ближайшего года будет распространено и на зоны Enterprise.

Устаревшие API:

• GET /zones/:zone_id/settings/brotli
• PATCH /zones/:zone_id/settings/brotli

Enterprise-клиенты могут переопределить стандартное поведение сжатия Cloudflare с помощью Compression Rules.

Auto Minify

Дата прекращения поддержки: August 5, 2024

Конечные точки API Auto Minify считаются устаревшими, так как функция Auto Minify была признана устаревшей.

Устаревшие API:

• GET /zones/:zone_id/settings/minify
• PATCH /zones/:zone_id/settings/minify

DNS Records: поле 'locked'

Дата прекращения поддержки: July 14, 2024

"locked" поле DNS-записей в ответах API не используется, и гарантированно всегда равно false уже более года. Это означает, что поле будет полностью исключено из ответов API. Если оно будет получено от клиента, оно, как и раньше, будет проигнорировано.

Измененный API:

• GET /zones/:zone_id/dns_records
• POST /zones/:zone_id/dns_records
• GET /zones/:zone_id/dns_records/:dns_record_id
• PATCH /zones/:zone_id/dns_records/:dns_record_id
• PUT /zones/:zone_id/dns_records/:dns_record_id

Мобильное перенаправление

Дата прекращения поддержки: June 30, 2024

Эта конечная точка и связанные с ней API устарели, вместо них используйте Single Redirects. См. Выполнение мобильной переадресации чтобы перенести Mobile Redirect на Redirect Rules.

Устаревший API:

• GET /zones/:zone_identifier/settings/mobile_redirect
• PATCH /zones/:zone_identifier/settings/mobile_redirect

Замена: Single Redirects

Server-Side Excludes

Дата прекращения поддержки: June 14, 2024

Функция Server-side Excludes и её конечные точки API считаются устаревшими.

Устаревшие API:

• GET /zones/:zone_id/settings/server_side_exclude
• PATCH /zones/:zone_id/settings/server_side_exclude

Поля данных, связанные с именем, в записях SRV (DNS)

Дата прекращения поддержки: May 31, 2024

Имя SRV записи обычно состоит из трёх частей: сервис (например, _xmpp), протокол (например, _tcp), и базовое имя (example.com).

Полное имя в этом случае будет, например, _xmpp._tcp.example.com.

При работе с записями DNS через API, записи SRV содержат как полное name а также data карта, содержащая отдельные компоненты имени:

{
  "name": "_xmpp._tcp.example.com",
  "data": {
    "service": "_xmpp",
    "proto": "_tcp",
    "name": "example.com",
    ...
  },
  ...
}

Мы прекращаем поддержку service, proto и name поля в течение data карты в пользу name поле снаружи карту данных, то есть то же поле name, которое используется для всех остальных типов записей.

До наступления даты завершения жизненного цикла убедитесь, что:

• при чтении SRV-записей вы используете только name за пределами карты данных и игнорировать service, proto и name в карте данных, если они существуют; и
• при записи SRV-записей вы указываете name за пределами карты данных и не задавайте service, proto или name в карте данных.

После даты окончания поддержки API перестанет возвращать service, proto и name полей данных, и если хотя бы одно из них получено от клиента, возвращается ошибка.

Это устаревание не затрагивает другие поля данных SRV, не упомянутые выше (priority, weight, port, target) или полей данных для любого типа записи, кроме SRV.

Измененный API:

• GET /zones/:zone_id/dns_records
• POST /zones/:zone_id/dns_records
• GET /zones/:zone_id/dns_records/:dns_record_id
• PATCH /zones/:zone_id/dns_records/:dns_record_id
• PUT /zones/:zone_id/dns_records/:dns_record_id

Удаление Privacy Pass API

Дата прекращения поддержки: March 31, 2024

В 2017 году Cloudflare анонсировала поддержку для Privacy Pass, протокола, появившегося сравнительно недавно и позволяющего пользователям анонимно подтверждать свою личность на разных сайтах без возможности отслеживания. Первоначальный сценарий использования состоял в том, чтобы выдавать сайтам не поддающиеся отслеживанию токены, подтверждающие пользователей, которым в противном случае пришлось бы проходить проверку CAPTCHA. С момента выхода этого протокола Privacy Pass продолжил развиваться как на уровне IETF и в Cloudflare. Версия, анонсированная в 2017 году, теперь считается устаревшей, и такие устаревшие токены Privacy Pass больше не поддерживаются в качестве альтернативы проверкам Cloudflare. Как уже говорилось в нашем блоге Конец эпохи CAPTCHA, Cloudflare использует разные сигналы, чтобы определить, является ли входящий трафик автоматизированным. Устаревшая настройка зоны Privacy Pass больше не имеет значения для клиентов Cloudflare, поскольку теперь Cloudflare использует Без CAPTCHA, и поддерживает новейшую Черновик Privacy Pass.

В сентябре 2023 года была прекращена поддержка устаревших токенов Privacy Pass как альтернативы Cloudflare Managed Challenge. К концу марта 2024 года будет удалён и текущий публичный API.

Устаревший API:

• GET zones/:zone_identifier/settings/privacy_pass
• POST zones/:zone_identifier/settings/privacy_pass

Argo Tunnel

Дата прекращения поддержки: February 4, 2024

Эта конечная точка и связанные с ней API устарели, вместо них используйте эквивалентные API Cloudflare Tunnels.

Устаревший API:

• GET accounts/:account_identifier/tunnels
• POST accounts/:account_identifier/tunnels
• GET accounts/:account_identifier/tunnels/:tunnel_id
• DELETE accounts/:account_identifier/tunnels/:tunnel_id

Замена: Cloudflare Tunnel API

Удаление TLS-шифра ChaCha20

Дата прекращения поддержки: July 1, 2023

Еще в 2016 году Cloudflare добавила поддержку для ChaCha20-Poly1305 наборов шифров для TLS 1.2. Тогда мы представили два варианта этих новых наборов: "стандартные" наборы, определенные в IETF RFC 7905, и "черновые" наборы, основанные на более раннем черновике этой спецификации. Черновые наборы были добавлены для совместимости с некоторыми старыми устройствами Android, которые на тот момент ещё не поддерживали корректную ChaCha20-Poly1305 стандартных версий. Это произошло в 2016 году, и с тех пор стандарт ChaCha20-Poly1305 наборов шифров получили гораздо более широкое распространение, и трафик с использованием старых наборов значительно сократился. Из-за низкой востребованности и нестандартного характера этих наборов шифров мы прекращаем их поддержку в сети Cloudflare.

Это никак не должно повлиять на зоны клиентов, поскольку клиенты, которые сейчас используют эти наборы шифров, смогут перейти на другие. Кроме того, в отличие от стандартных вариантов, эти устаревшие наборы шифров не предоставляются напрямую через наш API (например, через конечную точку настроек наборов шифров TLS), и их устаревание никак не повлияет на конфигурации клиентов.

С 1 июля 2023 года шифры ChaCha20-Poly1305 объявлены устаревшими и признаны Cloudflare полностью выведенными из эксплуатации. Если у вас есть клиенты, которые до сих пор используют эти шифры, настоятельно рекомендуется перевести их на более новые и безопасные шифры. Учтите, что эти устаревшие шифры будут полностью удалены в первом квартале 2024 года, после чего запросы, использующие их, начнут завершаться ошибкой. Примите меры заранее, чтобы обеспечить плавный переход и сохранить безопасность своих систем.

Заголовки Transfer-Encoding и Content-Length

Дата прекращения поддержки: July 1, 2023

Ранее RFC 2616 допускал использование Transfer-Encoding и Content-Length HTTP-заголовков в одном запросе. RFC 7230 заменяет собой RFC 2616 и запрещает использование Transfer-Encoding и Content-Length заголовков в одном запросе, поскольку это может привести к уязвимостям типа HTTP request smuggling.

Начиная с 1 июля 2023 года Cloudflare будет отклонять запросы, содержащие одновременно Transfer-Encoding и Content-Length HTTP-заголовков.

Account Billing Profile, User Billing Profile, and User Billing History

Дата прекращения поддержки: June 6, 2023

Замены этим конечным точкам через API нет. В качестве альтернативы войдите в свой аккаунт Cloudflare, чтобы просмотреть:

• Invoices & Billing Email
• Платежные подписки
• Платежная информация профиля выставления счетов

Устаревший API:

• GET accounts/{account_identifier}/billing/profile
• GET user/billing/profile
• GET user/billing/history

Load Balancing - notification_email

Дата прекращения поддержки: April 3, 2023

Это поле устарело и было перенесено в Централизованный сервис уведомлений Cloudflare.

notification_email это адрес электронной почты, на который отправляются уведомления о состоянии проверки работоспособности. Это может быть отдельный почтовый ящик или список рассылки. Можно указать несколько адресов через запятую.

Приложения Access типа Bookmark

Дата прекращения поддержки: March 19, 2023

Эта конечная точка устарела, вместо неё используйте специализированный API типа приложения Access Application App Type.

Устаревший API:

• GET accounts/:identifier/access/bookmarks
• GET accounts/:identifier/access/bookmarks/:uuid
• POST accounts/:identifier/access/bookmarks/:uuid
• PUT accounts/:identifier/access/bookmarks/:uuid
• DELETE accounts/:identifier/access/bookmarks/:uuid

Замена: Access applications app type API

Page Shield

Дата прекращения поддержки: October 11, 2022

Замените script_monitor в маршрутах Page Shield API с page_shield.

Cloudflare Images - Create authenticated direct upload URL v1

Дата прекращения поддержки: July 1, 2022

Эта конечная точка устарела, вместо неё используйте v2, которая позволяет управлять метаданными, задавать политику доступа и получать идентификатор изображения.

Устаревший API: POST accounts/:account_identifier/images/v1/direct_upload

Замена: POST accounts/:account_identifier/images/v2/direct_upload

Zone Analytics API

Дата прекращения поддержки: March 1, 2021

Этот API устарел, вместо него используйте GraphQL Analytics API, который предоставляет аналогичные данные и больше возможностей, включая выбор только нужных вам метрик. Дополнительную информацию можно найти в Руководство по переходу с аналитики зоны на аналитику GraphQL.

Устаревший API:

• GET zones/:zone_identifier/analytics/dashboard
• GET zones/:zone_identifier/analytics/colos

Замена: GraphQL Analytics API

Organizations

Дата прекращения поддержки: April 2, 2020

Эта конечная точка и связанные с ней API устарели, вместо них используйте /accounts эквивалентный API, который обладает более широким набором функций и обратно совместим с /organizations API.

Устаревший API:

• GET organizations/:identifier
• PATCH organizations/:identifier
• GET organizations/:organization_identifier/invites
• POST organizations/:organization_identifier/invites
• GET organizations/:organization_identifier/invites/:identifier
• PATCH organizations/:organization_identifier/invites/:identifier
• DELETE organizations/:organization_identifier/invites/:identifier
• GET organizations/:organization_identifier/members
• GET organizations/:organization_identifier/members/:identifier
• PATCH organizations/:organization_identifier/members/:identifier
• DELETE organizations/:organization_identifier/members/:identifier
• GET organizations/:organization_identifier/roles
• GET organizations/:organization_identifier/roles/:identifier
• GET organizations/:organization_identifier/audit_logs
• GET organizations/:organization_identifier/railguns
• POST organizations/:organization_identifier/railguns
• GET organizations/:organization_identifier/railguns/:identifier
• PATCH organizations/:organization_identifier/railguns/:identifier
• DELETE organizations/:organization_identifier/railguns/:identifier
• GET organizations/:organization_identifier/railguns/:identifier/zones

Замена: Accounts API