26 октября Cloudflare начала менять формат настроек Advanced Nameservers в DNS API. Вместо одного признака foundation_dns теперь используется отдельное значение nameservers.type: cloudflare.advanced. На Mentoring.digital объясняем, что это означает для скриптов управления DNS и клиентов с фиксированным перечнем допустимых типов.
Новый тип появляется постепенно
Изменение касается настроек DNS-зоны и настроек по умолчанию на уровне аккаунта. Cloudflare ожидает, что развёртывание займёт семь дней. Пока обновление не дошло до конкретного аккаунта, чтение настроек Advanced Nameservers может по-прежнему возвращать тип cloudflare.standard.
При этом PATCH-запросы уже принимают cloudflare.advanced для аккаунтов, которым доступна эта возможность. Поэтому разработчику важно учитывать переходное состояние: поддержка нового значения при записи и его появление в ответе чтения происходят не обязательно одновременно.
Старый признак пока поддерживается
Булево поле foundation_dns сохранено как устаревающий совместимый вариант. Во время перехода его можно читать и записывать. Если PATCH-запрос содержит и это поле, и nameservers.type, значения должны согласовываться: противоречащую комбинацию API отклонит.
Для новых операций записи Cloudflare рекомендует использовать cloudflare.advanced. В дальнейшем foundation_dns уберут из API, однако точная дата удаления в объявлении не указана. Интеграции, которые считают перечень значений nameservers.type закрытым, нужно научить распознавать новый вариант.
Что проверить в своей интеграции
Проверьте модель ответа, валидацию допустимых значений и формирование PATCH-запроса. Отдельно убедитесь, что код различает настройки зоны и значения по умолчанию для аккаунта. На тестовых данных полезно проверить чтение обоих вариантов ответа и отказ при заведомо противоречивых параметрах.
Обновление меняет представление настроек в API. Оно не меняет подписку Foundation DNS, не включает и не выключает Advanced Nameservers на зонах и не требует миграции зоны. Разобрать совместимость API-клиента и проверку ответов можно с наставником по серверным интеграциям.
