Ukončení podpory API

Zone Settings Batch API

Datum ukončení platnosti: April 23, 2025

Datum konce životnosti: March 31, 2027

Aktualizace: Datum konce životnosti tohoto vyřazení bylo prodlouženo na 31. března 2027 (dříve 15. září 2026).

Koncové body Zone Settings Batch API, které v jednom požadavku čtou a upravují více nastavení zóny, jsou zastaralé a jejich podpora skončí 31. března 2027. Pro čtení a úpravu jednotlivých nastavení zóny použijte místo nich koncové body pro jednotlivá nastavení.

Zastaralá API:

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

Náhrady:

• Získání nastavení zóny, GET /zones/{zone_id}/settings/{setting_id}
• Edit zone setting, PATCH /zones/{zone_id}/settings/{setting_id}

Integrace, které v jediném volání čtou nebo upravují více nastavení, musí před 31. březnem 2027 přejít na požadavky pro jednotlivá nastavení, aby byla zajištěna nepřerušená služba. Po tomto datu už dávkové koncové body nebudou k dispozici.

Booleovské nastavení Foundation DNS

Datum ukončení platnosti: July 27, 2026

Datum konce životnosti: November 23, 2026

foundation_dns boolean se ruší v Koncové body nastavení DNS pro nastavení zóny a výchozí hodnoty účtu. Použijte nameservers.type: "cloudflare.advanced" pro konfiguraci Advanced Nameservers místo toho.

Ovlivněné koncové body:

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

Od 26. října 2026 bude DNS settings API postupně reprezentovat Advanced Nameservers pomocí nameservers.type: "cloudflare.advanced". Toto nasazení by mělo trvat sedm dní. Než nasazení daný účet zasáhne, API bude nadále vracet nameservers.type: "cloudflare.standard" pro Advanced Nameservers. API bude přijímat nameservers.type: "cloudflare.advanced" v PATCH požadavky pro oprávněné účty po celou dobu zavádění.

foundation_dns boolean zůstává během tohoto přechodu dostupný jako alias pro zpětnou kompatibilitu. Můžete jej i nadále číst a zapisovat. Pokud PATCH požadavek obsahuje obě hodnoty, musí se shodovat. API konfliktní hodnoty odmítne.

Od 23. listopadu 2026 už DNS settings API nebude vracet ani přijímat foundation_dns. Toto nasazení by mělo trvat sedm dní. PATCH požadavky, které obsahují foundation_dns bude odmítnuto. Aktualizujte klienty, které zpracovávají nameservers.type jako uzavřený enum, aby bylo možné rozpoznat "cloudflare.advanced" hodnotu a aktualizujte klienty, které čtou nebo zapisují foundation_dns před datem ukončení podpory. Tato změna API nemá vliv na vaše předplatné Foundation DNS ani na to, zda máte na svých zónách povolené Advanced Nameservers. Migrace zóny se nevyžaduje.

Limit 65 znaků pro název účtu

Datum vynucení: September 27, 2026

Názvy účtů budou omezeny na maximálně 65 znaků ve všech API pro vytváření a aktualizaci účtů. Tento limit platí pro všechny účty, včetně účtů organizací. V současné době rozhraní API pro aktualizaci účtu (PUT /accounts/{account_id}) toto omezení již vynucuje, zatímco API pro vytváření účtu (POST /accounts) tiše zkracuje názvy na 120 bajtů. Tento nesoulad může vést k účtům, které se úspěšně vytvoří, ale později je nelze přejmenovat. Po 27. září 2026 bude API pro vytváření odmítat názvy delší než 65 znaků chybou HTTP 400 chyba.

Ovlivněná API:

• POST /accounts : Vytvořit účet
• PUT /accounts/{account_id}, Aktualizace účtu (již vynucováno)

Po datu vynucení musí integrace, které vytvářejí účty s názvy delšími než 65 znaků, název před odesláním požadavku zkrátit, aby provoz služby zůstal zachován bez přerušení.

API rolí účtu

Datum ukončení platnosti: July 21, 2026

API rolí účtu v současnosti vrací pouze role na úrovni účtu a je zastaralý ve prospěch Permission Groups API. Permission Groups API je podporovaný způsob, jak vypsat role na úrovni účtu, zóny a prostředků, které lze udělit členům účtu.

Zastaralá API:

• GET /accounts/{account_id}/roles, Seznam rolí
• GET /accounts/{account_id}/roles/{role_id}, Podrobnosti o roli

Náhrady:

• GET /accounts/{account_id}/iam/permission_groups : Seznam skupin oprávnění účtu
• GET /accounts/{account_id}/iam/permission_groups/{permission_group_id}, Podrobnosti o skupině oprávnění

Schéma odpovědi se liší od starší odpovědi Roles:

• Starší Role odpověď obsahuje na nejvyšší úrovni description a permissions objekt indexovaný podle typu prostředku s příznaky pro úpravy a čtení.
• PermissionGroup odpověď je nahrazuje jedním meta objekt obsahující label a scopes. Jednotlivá oprávnění nejsou součástí vrácené skupiny oprávnění.

Další poznámky:

• Integrace přecházející na Permission Groups API musí ID skupin oprávnění získávat z tohoto API a používat je ve tvaru požadavků zásad Account Members API. Integrace, které si ukládají starší ID rolí, budou muset svá přiřazení přemapovat.
• Oba koncové body používají standardní obálku odpovědi Cloudflare, takže stránkování a zpracování chyb se nemění.
• Nové API podporuje API Token ověřovací schéma. Starší schéma ověřování Email + API Key zůstává k dispozici kvůli zpětné kompatibilitě.
• Ovlivněný Terraform resource je cloudflare_account_role zdroj dat. Budete muset přejít na cloudflare_account_permission_group zdroj dat.

Workers KV: Legacy Namespace Routes

Datum ukončení platnosti: July 15, 2026

Datum konce životnosti: October 15, 2026

Starší trasy API Workers KV pod /accounts/{account_id}/workers/namespaces/* se ruší ve prospěch Workers KV API trasy pod /accounts/{account_id}/storage/kv/namespaces/*.

Starší a nové trasy jsou vzájemně zaměnitelné. Přijímají stejné parametry požadavku a vracejí stejný obsah odpovědi. Při migraci stačí změnit cestu URL z /workers/namespaces/ na /storage/kv/namespaces/.

Zastaralá API:

• GET a POST /accounts/{account_id}/workers/namespaces (výpis a vytváření namespace)
• GET, PUT, a DELETE /accounts/{account_id}/workers/namespaces/{namespace_id} (získání, přejmenování a odstranění namespace)
• GET /accounts/{account_id}/workers/namespaces/{namespace_id}/keys (výpis klíčů)
• GET /accounts/{account_id}/workers/namespaces/{namespace_id}/metadata/{key_name} (čtení metadat klíče)
• GET, PUT, a DELETE /accounts/{account_id}/workers/namespaces/{namespace_id}/values/{key_name} (čtení, zápis a mazání párů klíč-hodnota)

Náhrady:

Aktualizujte cestu URL z /workers/namespaces/ na /storage/kv/namespaces/ v každém koncovém bodě.

• GET a POST /accounts/{account_id}/storage/kv/namespaces (výpis a vytváření namespace)
• GET, PUT, a DELETE /accounts/{account_id}/storage/kv/namespaces/{namespace_id} (získání, přejmenování a odstranění namespace)
• GET /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/keys (výpis klíčů)
• GET /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/metadata/{key_name} (čtení metadat klíče)
• GET, PUT, a DELETE /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key_name} (čtení, zápis a mazání párů klíč-hodnota)

Po 15. říjnu 2026 budou požadavky na starší /accounts/{account_id}/workers/namespaces/* trasy již nebudou podporovány. Před tímto datem aktualizujte integrace tak, aby používaly zdokumentované koncové body Workers KV API a zajistily tak nepřerušený provoz.

Zero Trust Networks Route Endpoints and Cloudflare Tunnel Connections Field

Datum ukončení platnosti: July 9, 2026

Datum konce životnosti: October 5, 2026

Dvě související změny Zero Trust Networks API a Cloudflare Tunnel API nabydou účinnosti 5. října 2026.

Koncové body pro trasy

Koncové body pro trasy kódované ve formátu CIDR jsou zastaralé ve prospěch standardního route_id-based koncové body, které dnes již existují.

Zastaralá 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}

Náhrady:

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

Připojení Cloudflare Tunnel a Cloudflare Mesh

connections pole se odstraňuje z odpovědí na list a get pro uzly Cloudflare Tunnel a Cloudflare Mesh (cfd_tunnel a warp_connector API resources). Místo čtení tohoto pole z objektu tunelu nebo uzlu použijte vyhrazený endpoint pro připojení.

Ovlivněná 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}

Náhrady:

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

Úplné pokyny k migraci, včetně curl příklady a cloudflared a poznámky k Terraformu najdete v Seznam změn Cloudflare Tunnel.

AMP/SXG API and Rules

Datum ukončení platnosti: September 18, 2025

Datum konce životnosti: June 23, 2026

Funkce AMP/SXG dosáhly konce životnosti. Nebude existovat žádná náhradní funkce. Koncové body API nastavení zóny a sxg Nastavení Configuration Rule by se již neměly používat.

Zastaralá API:

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

Zastaralé nastavení Configuration Rule:

• sxg

Uživatelské rozhraní dashboardu už nebude zobrazovat odkazy na AMP ani nastavení sxg. Parametr sxg lze z pravidel (rulesets) odstranit pomocí rulesets API. Ukončení podpory v Terraformu bude následovat později, uživatelé by proto měli odstranit odkazy na sxg parametr z jejich terraform.

Legacy Registrar Domain Management API

Datum ukončení platnosti: April 10, 2026

Datum konce životnosti: September 27, 2026

Starší koncové body pro správu domén Registrar jsou zastaralé a jejich životnost skončí 27. září 2026. Byly nahrazeny novými Registrar API, která poskytuje možnosti vyhledávání domén, kontroly dostupnosti a registrace.

Zastaralá API:

• GET /accounts/{account_id}/registrar/domains, Seznam domén
• GET /accounts/{account_id}/registrar/domains/{domain_name} : Získat doménu
• PUT /accounts/{account_id}/registrar/domains/{domain_name}, Aktualizace domény

Náhrada: Registrar API

• Vyhledat dostupné domény, GET /accounts/{account_id}/registrar/domain-search
• Zkontrolovat dostupnost domény, POST /accounts/{account_id}/registrar/domain-check
• Seznam registrací, GET /accounts/{account_id}/registrar/registrations
• Vytvořit registraci, POST /accounts/{account_id}/registrar/registrations

Zákazníci a integrace používající starší koncové body pro správu domén musí před 27. zářím 2026 přejít na nové Registrar API, aby byla zajištěna nepřerušená služba. Po tomto datu už starší koncové body nebudou dostupné.

Auditní pravidla SSH v Gateway

Datum ukončení platnosti: November 3, 2025

Datum konce životnosti: July 15, 2026

Akce Gateway Audit SSH pro síťové zásady je zastaralé a bude zcela odstraněno 15. července 2026. SSH s Access for Infrastructure nahrazuje správu a auditování přístupu přes SSH.

Vytváření nových pravidel Gateway pomocí action: "audit_ssh" prostřednictvím dashboardu bylo zakázáno v prosinci 2024. Vytváření nových pravidel prostřednictvím API a Terraformu bylo zakázáno 3. listopadu 2025. Úprava existujících pravidel prostřednictvím dashboardu, API a Terraformu byla zakázána 15. ledna 2026. Dne 15. července 2026 přestanou fungovat všechna zbývající pravidla Audit SSH.

Zastaralá API:

• POST /accounts/{account_id}/gateway/rules, vytváření pravidel s action: "audit_ssh" se již nepřijímá
• PUT /accounts/{account_id}/gateway/rules/{rule_id}, úprava pravidel s action: "audit_ssh" se již nepřijímá

Náhrada: SSH s Access for Infrastructure

Ověřování Service Key

Datum ukončení platnosti: March 19, 2026

Datum konce životnosti: September 30, 2026

Ověřování Service Key pro rozhraní Cloudflare API je zastaralé a bude odstraněno September 30, 2026. API Tokens dokážou poskytnout veškerou funkčnost Service Keys a navíc podporují jemně odstupňované oprávnění, expiraci a omezení podle IP adresy.

Zastaralé chování:

• Autentizace požadavků API pomocí X-Auth-User-Service-Key hlavička.
• Generování nových Service Keys přes Cloudflare dashboard nebo API. Možnost generovat nové Service Keys z dashboardu bude brzy odstraněna.

Náhrada:

• Vytvořte API token s odpovídajícími oprávněními pro váš případ použití. Tokeny API podporují jemně odstupňovaný rozsah, platnost a možnost zneplatnění.

Uživatelé cloudflared by se měli ujistit, že používají verzi z listopadu 2022 nebo novější, která místo Service Keys používá API Tokens. Uživatelé origin-ca-issuer by měli přejít na verzi, která podporuje ověřování pomocí API Token.

Aktualizace typů záznamů DNS prostřednictvím API

Datum ukončení platnosti: January 23, 2026

Datum konce životnosti: June 30, 2026

Změna typu existujícího DNS záznamu přes API je zastaralá (deprecated) a po June 30, 2026 již nebude podporována.

Změna typu DNS záznamu není běžná aktualizační operace a obvykle vyžaduje i změnu obsahu záznamu. Aktualizace atributů, jako je název, TTL nebo obsah, jsou běžné a bezpečné, ale změna typu záznamu přináší dodatečnou složitost validace a rizika pro konzistenci.

V zájmu souladu se správnou sémantikou DNS a snížení provozního rizika Cloudflare ukončuje podporu změny typu záznamu DNS na místě. Toto chování již existuje u poskytovatele Terraform v5, kde změna typu záznamu vede k operaci smazání a opětovného vytvoření místo aktualizace.

Zastaralé chování:

• Pomocí DNS Records API pro změnu typu existujícího záznamu.

Chování při nahrazení:

• Odstraňte stávající záznam DNS a Vytvoření nového DNS záznamu s požadovaným typem a obsahem.

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

  POST /zones/{zone_id}/dns_records

• Použijte Dávkové DNS záznamy API pro provedení obou operací v jediném požadavku.

  POST /zones/{zone_id}/dns_records/batch

Zákazníci a integrace, které se spoléhají na přímou aktualizaci typu záznamu, musí před 30. červnem 2026 přejít na postup smazání a opětovného vytvoření záznamu, aby byla zajištěna nepřerušená služba. Po tomto datu už nebude možné měnit typ záznamu pomocí aktualizačních operací.

Starší analytika autoritativní DNS a DNS Firewall

Datum ukončení platnosti: December 9, 2025

Datum konce životnosti: December 1, 2026

Následující rozhraní REST API jsou zastaralá a jejich životnost skončí 1. prosince 2026.

• DNS Analytics API
• DNS Firewall Analytics API

Veškerou stávající funkčnost plně podporuje GraphQL Analytics API společnosti Cloudflare, které nabízí lepší výkon, flexibilitu a dlouhodobou podporu. Aby integrace využívající REST API fungovaly bez přerušení, je nutné je do 1. prosince 2026 migrovat na nové GraphQL API.

Zastaralá 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)

Náhrady:

• GraphQL API pro DNS Analytics
• GraphQL API pro DNS Firewall Analytics

Zero Trust Devices

Datum konce životnosti: November 11, 2025

Měníme definici pojmu Devices. Devices budou nově představovat fyzická zařízení v reálném světě, zatímco vztah mezi Users a Devices bude vyjadřovat nový koncept: Registrations.

V důsledku toho se několik polí přesouvá z Devices do Registrations a níže uvedené koncové body označujeme za zastaralé.

Zastaralé koncové body nejsou podporovány u účtů s víceuživatelský režim zapnuté.

Zastaralé 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

Náhrada:

• 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

Datum ukončení platnosti: November 2025

Datum konce životnosti: January 2026

V návaznosti na ukončení podpory Cloudflare Mirage, jsou následující koncové body API pro správu nastavení Mirage nyní zastaralé a v lednu 2026 budou ukončeny.

Zastaralá API:

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

Ovlivněná API:

• GET /zones/{zone_id}/pagerules/settings - Mirage bude odstraněn z dostupných nastavení.
• POST /zones/{zone_id}/pagerules - Parametr Mirage bude odstraněn.
• PATCH /zones/{zone_id}/pagerules/{rule_id} - Parametr Mirage bude odstraněn.
• PUT /zones/{zone_id}/pagerules/{rule_id} - Parametr Mirage bude odstraněn.
• GET /zones/{zone_id}/rulesets/{ruleset_id} - Parametr Mirage v set_config akce bude odebrána.
• GET /zones/{zone_id}/rulesets/{ruleset_id}/versions/{version_id} - Parametr Mirage v set_config akce bude odebrána.
• POST /zones/{zone_id}/rulesets - Parametr Mirage v set_config akce bude odebrána.
• PUT /zones/{zone_id}/rulesets/{ruleset_id} - Parametr Mirage v set_config akce bude odebrána.
• POST /zones/{zone_id}/rulesets/{ruleset_id}/rules - Parametr Mirage v set_config akce bude odebrána.
• PATCH /zones/{zone_id}/rulesets/{ruleset_id}/rules/{rule_id} - Parametr Mirage v set_config akce bude odebrána.
• GET /accounts/{account_id}/rulesets/{ruleset_id} - Parametr Mirage v set_config akce bude odebrána.
• GET /accounts/{account_id}/rulesets/{ruleset_id}/versions/{version_id} - Parametr Mirage v set_config akce bude odebrána.
• POST /accounts/{account_id}/rulesets - Parametr Mirage v set_config akce bude odebrána.
• PUT /accounts/{account_id}/rulesets/{ruleset_id} - Parametr Mirage v set_config akce bude odebrána.
• POST /accounts/{account_id}/rulesets/{ruleset_id}/rules - Parametr Mirage v set_config akce bude odebrána.
• PATCH /accounts/{account_id}/rulesets/{ruleset_id}/rules/{rule_id} - Parametr Mirage v set_config akce bude odebrána.

Cloudflare Radar: Summary and Timeseries Groups Endpoints

Datum ukončení platnosti: October 15, 2025

Datum konce životnosti: April 15, 2026

Radar API má v současnosti pro každou datovou sadu více koncových bodů pro souhrny a časové řady (například /radar/http/summary/device_type a /radar/http/timeseries_groups/device_type), které sdílejí téměř identické parametry a schéma. Za účelem zjednodušení API a zlepšení udržovatelnosti budou tyto koncové body nahrazeny parametrizovanými koncovými body pomocí {dimension} parametr cesty.

Zastaralá 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
• Další podobné souhrnné a časové (timeseries) skupinové koncové body jsou dostupné pro následující datové sady: AI Bots, AI Inference, AS112, DNS, Email Routing, Email security, HTTP, Layer 3 Attacks, Layer 7 Attacks, Leaked Credential Checks

Náhrady:

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

Zde {dimension} je povinný parametr cesty, který uvádí všechny dostupné dimenze datové sady.

Pokud voláte API přímo (nikoli přes Cloudflare SDK), není potřeba nic dělat. Pokud používáte SDK, doporučujeme přejít na nové operace, aby byla po odstranění starých operací zajištěna kompatibilita.

Cloudflare Radar: Verified Bots APIs

Datum ukončení platnosti: July 1, 2025

Datum konce životnosti: January 1, 2026

Radar Verified Bots API je nyní zastaralé a bude nahrazeno novým Bots API.

Zastaralá API:

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

Náhrady:

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

Cloudflare DWeb Resolver

Datum ukončení platnosti: July 1, 2025

Experiment Cloudflare DWeb Resolver končí.

Zastaralá API:

• Resolver DoH na resolver.cloudflare-eth.com

Firewall Rules API and Filters API

Datum ukončení platnosti: June 15, 2025

Firewall Rules API a Filters API jsou zastaralé, protože Firewall Rules bylo zrušeno ve prospěch WAF custom rules. Viz Upgrade na Firewall Rules pro další informace o této změně.

Zastaralá 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

Náhrada: WAF custom rules

API spravovaných pravidel WAF (předchozí verze)

Datum ukončení platnosti: June 15, 2025

API pro správu spravovaných pravidel WAF (předchozí verze), tedy pro správu balíčků, skupin pravidel, jednotlivých pravidel a override, jsou zastaralá. Místo nich použijte Rulesets API pro správu nové verze WAF Managed Rules. Viz Aktualizace WAF Managed Rules pro další informace o této změně.

Zastaralá 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

Náhrada: WAF Managed Rules (nová verze)

Rate Limiting API (předchozí verze)

Datum ukončení platnosti: June 15, 2025

Rate Limiting API je zastaralé ve prospěch používání Rulesets API pro správu nového pravidla rate limitingu. Viz Aktualizace Rate limiting (předchozí verze) pro další informace o této změně.

Zastaralé 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

Náhrada: Rate limiting rules (nová verze)

Zone Setting: cname_flattening

Datum ukončení platnosti: June 8, 2025

Koncové body API nastavení zóny pro správu CNAME flattening na úrovni zóny jsou zastaralé. Místo nich použijte Zobrazit nastavení DNS a Aktualizovat nastavení DNS koncové body ke správě tohoto nastavení.

Změny provedené přes staré endpointy se projeví i v nových, a naopak, takže není nutné migrovat stávající zóny. Budoucí volání API však musí používat DNS Settings místo Zone Settings endpoints.

Mějte na paměti, že u zastaralého nastavení zóny hodnoty "off" a "apex" mají stejné chování. Jsou reprezentovány jako {"flatten_all_cnames": false} v novém API. Nastavení zóny "on" odpovídá {"flatten_all_cnames": true} v novém API.

Ovlivněná API:

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

Zastaralá API:

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

Eligible Zones For Account Custom Nameservers

Datum ukončení platnosti: March 23, 2025

Uživatelé nyní mohou přidávat vlastní nameservery, které nejsou součástí zóny spravované v rámci jejich účtu. Díky tomu lze vlastní nameservery použít pro libovolnou zónu bez ohledu na to, zda ji spravuje Cloudflare. Vzhledem k této změně přestal být endpoint pro kontrolu způsobilých zón potřebný, a je proto nyní deprecated.

Zastaralá API:

• GET /accounts/:account_id/custom_ns/availability

Cloudflare Radar: Attack top industry and vertical endpoints

Datum ukončení platnosti: March 20, 2025

Datum konce životnosti: September 20, 2025

/top/industry a /top/vertical pro útoky se nyní ruší a nahradí je odpovídající souhrnné endpointy.

Ovlivněná 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

Náhrady:

• 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: Security level a Threat Score jsou nyní automatizované

Datum změny: March 17, 2025

Cloudflare nyní kombinuje signál rizika podle IP adresy s prahovými hodnotami a daty o botnetech, takže úroveň citlivosti už není nutné nastavovat. Nastavení Security level přes Cloudflare dashboard už nebude uživatelům dostupné. Uživatelé je ale mohou stále nastavit přes stávající API nebo konfiguraci Terraform.

Pokud ve výrazech pravidel používáte threat score, měli byste tyto výrazy zkontrolovat a ověřit, že se pravidlo stále spouští tak, jak má. Cloudflare v budoucnu vaši konfiguraci zkontroluje a migruje, aby aktualizoval veškeré odkazy na threat score. Pokud ke konfiguraci používáte Rulesets API nebo Terraform, měli byste své skripty a pipeline zkontrolovat před koncem Q1 2026, abyste předešli problémům.

Account Settings: default_nameservers and use_account_custom_ns_by_default

Datum ukončení platnosti: March 14, 2025

Pole "default_nameservers" a "use_account_custom_ns_by_default" v rámci "settings" objekt účtů je zastaralý. Místo toho použijte Zobrazit nastavení DNS a Aktualizovat nastavení DNS koncové body ke správě tohoto nastavení. Toto nastavení je v nové verzi API dostupné jako .zone_defaults.nameservers.type, s povolenými hodnotami "cloudflare.standard", "cloudflare.standard.random", "custom.account" a "custom.tenant".

Změny provedené přes staré endpointy se projeví i v nových, a naopak, takže není nutné migrovat stávající zóny. Budoucí volání API však musí používat DNS Settings místo Accounts endpoints.

Ovlivněná API:

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

Cloudflare Radar: Layer 7 attack magnitude parameter

Datum ukončení platnosti: March 11, 2025

Datum konce životnosti: June 11, 2025

Útok na vrstvě 7 magnitude parametr dotazu, který umožňuje definovat velikost útoku podle celkového počtu zmírněných požadavků (MITIGATED_REQUESTS) nebo celkový počet napadených zón (AFFECTED_ZONES), je zastaralé. Cloudflare Radar bude nadále podporovat definování rozsahu útoků na vrstvě 7 pouze na základě celkového počtu zmírněných požadavků.

Ovlivněné API:

GET /radar/attacks/layer7/top/attacks

Náhrada:

Uživatelé by měli přestat používat magnitude parametr, protože výchozí chování již používá MITIGATED_REQUESTS.

DNS Records API: změny parametrů filtrování

Datum ukončení platnosti: February 21, 2025

Následující parametry URL pro filtrování záznamů DNS jsou zastaralé:

• name=contains:value Místo toho použijte podporované name.contains=value syntaxe.
• name=starts_with:value Místo toho použijte podporované name.startswith=value syntaxe.
• name=ends_with:value Místo toho použijte podporované name.endswith=value syntaxe.
• name=one,two,three (vyhledávání jednoho z více možných názvů oddělených čárkami) Místo toho odešlete více požadavků, jeden pro každý možný name. Alternativně, pokud dotazujete pouze name pole, ?match=any&name=one&name=two&name=three syntaxi lze použít místo toho. Tato syntaxe má prodloužené datum ukončení podpory 23. května 2025.
• content=contains:value Místo toho použijte podporované content.contains=value syntaxe.
• content=starts_with:value Místo toho použijte podporované content.startswith=value syntaxe.
• content=ends_with:value Místo toho použijte podporované content.endswith=value syntaxe.
• content=one,two,three (vyhledávání jednoho z více možných obsahů oddělených čárkami) Místo toho odešlete více požadavků, jeden pro každý možný content. Alternativně, pokud dotazujete pouze content pole, ?match=any&content=one&content=two&content=three syntaxi lze použít místo toho. Tato syntaxe má prodloužené datum ukončení podpory 23. května 2025.
• type=contains:value Vyhledávání podřetězců v názvu typu již nebude podporováno. Místo toho vyhledejte přesný název typu, například type=CNAME. Pokud je vstupní hodnota volným textovým vyhledáváním od uživatele, zvažte použití search parametr.

Žádný z parametrů, které se ruší, nebyl podle naší dokumentace API nikdy oficiálně podporován.

Ovlivněná API:

• GET /zones/:zone_id/dns_records

Aplikace Access: self_hosted_domains

Datum ukončení platnosti: November 21, 2025

self_hosted_domains pole pro Aplikace Access je zastaralé a nahrazuje ho destinations aby bylo možné pružněji definovat různé typy domén.

Před:

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

Poté:

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

API bude akceptovat obě pole až do data ukončení podpory. Pokud self_hosted_domains jsou zadány, budou interpretovány jako public cílů. Pokud však destinations jsou zadány, pak self_hosted_domains bude ignorováno, i když je uvedeno.

Rozhraní API navíc bude i nadále vracet self_hosted_domains až do data ukončení podpory. Pole bude obsahovat identifikátory URI podmnožiny cílů, které mají typ public.

Ovlivněná 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

Informace o zóně v jednotlivých záznamech DNS

Datum ukončení platnosti: November 30, 2024

Každý jednotlivý DNS záznam vrácený rozhraním API v současnosti obsahuje informace o zóně, ve které se nachází, konkrétně ID a název zóny.

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

Tato informace je nadbytečná, protože obě dotčené trasy API již spadají do rozsahu zóny. ID zóny navíc bude znát každý uživatel těchto tras, protože se objevuje přímo v URL. Název zóny lze získat zavoláním GET požadavek na /zones/:zone_id pokud je to nutné.

Po 30. listopadu 2024 přestane Cloudflare zahrnovat zone_id a zone_name pole u jednotlivých DNS záznamů v odpovědích API. Tato pole se v současnosti při odeslání do API jako součást těla požadavku ignorují, takže těla požadavků není nutné nijak měnit.

Upravené 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: řetězce chyb u chyb ověřování DNS

Datum ukončení platnosti: October 1, 2024

Cloudflare mírně mění způsob zobrazení některých chyb při vytváření DNS záznamů. Pokud je v současnosti vytvářený DNS záznam neplatný, může se zobrazit chyba podobná této:

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

Po 1. říjnu 2024 bude error_chain bude vynechána a vrátí se přímo hlavní příčina, aniž by byla zabalena do další chyby „DNS Validation Error“:

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

Legacy DNS Settings Endpoints

Datum ukončení platnosti: September 13, 2024

Vyhrazené koncové body pro nastavení DNS use_apex_ns a secondary_overrides se ruší.

Místo toho použijte Zobrazit nastavení DNS a Aktualizovat nastavení DNS koncové body ke správě tohoto nastavení.

• Místo .../use_apex_ns koncový bod, použijte multi_provider .
• Místo .../secondary_overrides koncový bod, použijte secondary_overrides .

Zastaralá 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

Datum ukončení platnosti: August 15, 2024

Nastavení Brotli a jeho koncové body API jsou zastaralé. Komprese Brotli je dostupná pro všechny zóny mimo Enterprise a v nadcházejícím roce bude rozšířena i na zóny Enterprise.

Zastaralá API:

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

Zákazníci s plánem Enterprise mohou přepsat výchozí chování komprese Cloudflare pomocí Compression Rules.

Auto Minify

Datum ukončení platnosti: August 5, 2024

Koncové body API pro Auto Minify jsou zastaralé, protože funkce Auto Minify byla ukončena.

Zastaralá API:

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

DNS Records: pole „locked“

Datum ukončení platnosti: July 14, 2024

"locked" pole u DNS záznamů v odpovědích API se nepoužívá a je zaručeno, že vždy bude false již déle než rok. Toto ukončení podpory znamená, že pole bude z odpovědí API zcela vynecháno. Pokud bude přijato od klienta, bude i nadále ignorováno, stejně jako dnes.

Upravené 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

Přesměrování na mobilní zařízení

Datum ukončení platnosti: June 30, 2024

Tento endpoint a související API jsou zastaralé a jsou nahrazeny Single Redirects. Viz Přesměrování mobilních zařízení pro migraci Mobile Redirect na Redirect Rules.

Zastaralé API:

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

Náhrada: Single Redirects

Server-side Excludes

Datum ukončení platnosti: June 14, 2024

Funkce Server-side Excludes a její koncové body API jsou zastaralé.

Zastaralá API:

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

Datová pole související s názvem u záznamů SRV (DNS)

Datum ukončení platnosti: May 31, 2024

Název záznamu SRV se obvykle skládá ze tří částí: služby (např. _xmpp), protokol (např. _tcp), a základní název (example.com).

Úplný název by pak byl například _xmpp._tcp.example.com.

Při práci se záznamy DNS prostřednictvím API, záznamy SRV obsahují jak úplný name a také data mapu obsahující jednotlivé součásti názvu:

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

Ukončujeme podporu pro service, proto a name pole během data mapu ve prospěch name pole mimo datovou mapu, což je stejné pole name, jaké se používá u všech ostatních typů záznamů.

Před datem ukončení podpory se ujistěte, že:

• při čtení záznamů SRV používáte pouze name mimo datovou mapu a ignoruje service, proto a name v datové mapě, pokud existují; a
• při zápisu záznamů SRV nastavujete name mimo datovou mapu a nenastavovat service, proto nebo name v datové mapě.

Po datu ukončení podpory přestane API vracet service, proto a name datová pole, a pokud je server od klienta obdrží, vrátí se chyba.

Toto vyřazení se netýká ostatních polí dat SRV, která nejsou uvedena výše (priority, weight, port, target) nebo datová pole pro jakýkoli jiný typ záznamu než SRV.

Upravené 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

Odebrání API Privacy Pass

Datum ukončení platnosti: March 31, 2024

V roce 2017 Cloudflare oznámená podpora pro Privacy Pass, novější protokol, který uživatelům umožňuje anonymně prokázat svou identitu na více webech, aniž by tím umožnili sledování. Původním případem použití bylo poskytování nevystopovatelných tokenů webům jako záruky za uživatele, kterým by jinak byla zobrazena CAPTCHA výzva. Od tohoto vydání se Privacy Pass dále vyvíjel jak na IETF a v rámci Cloudflare. Verze oznámená v roce 2017 se nyní považuje za zastaralou a tyto starší tokeny Privacy Pass se již nepodporují jako alternativa k výzvám Cloudflare. Jak jsme popsali na našem blogu Konec cesty pro CAPTCHA, Cloudflare využívá řadu signálů k odhadu, zda je příchozí provoz pravděpodobně automatizovaný. (Starší) nastavení zóny Privacy Pass již pro zákazníky Cloudflare nemá význam, protože Cloudflare nyní provozuje Bez CAPTCHA, a podporuje nejnovější Návrh Privacy Pass.

V září 2023 byla odebrána podpora starších tokenů Privacy Pass jako alternativy k Cloudflare Managed Challenge. Do konce března 2024 bude odebráno i současné veřejné API.

Zastaralé API:

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

Argo Tunnel

Datum ukončení platnosti: February 4, 2024

Tento endpoint a související API jsou zastaralé a jsou nahrazeny odpovídajícími API Cloudflare Tunnels.

Zastaralé 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

Náhrada: Cloudflare Tunnel API

Odstranění TLS šifry ChaCha20

Datum ukončení platnosti: July 1, 2023

V roce 2016 Cloudflare zavedena podpora pro ChaCha20-Poly1305 šifrovacích sad pro TLS 1.2. Tehdy jsme zavedli dvě varianty těchto nových sad: „standardní“ sady definované v IETF RFC 7905 a „draft“ sady, které vycházely z dřívějšího návrhu této specifikace. Sady draft byly přidány kvůli kompatibilitě s některými staršími zařízeními Android, jež v té době ještě nepodporovala řádné ChaCha20-Poly1305 standardní verze. Bylo to v roce 2016 a mezitím se standard ChaCha20-Poly1305 šifrovací sady se mezitím mnohem více rozšířily, takže provoz využívající staré sady výrazně poklesl. Vzhledem k jejich nízkému současnému využití a nestandardní povaze tyto šifrovací sady nyní v síti Cloudflare rušíme.

Toto by nemělo mít žádný vliv na zóny zákazníků, protože klienti, kteří tyto sady šifer aktuálně případně používají, budou moci přejít na jiné. Na rozdíl od standardních variant navíc tyto starší (legacy) sady šifer nejsou přímo vystaveny přes naše API (například přes endpoint pro předvolby sad šifer TLS), a jejich vyřazení tak nijak neovlivní konfigurace zákazníků.

Od 1. července 2023 jsou šifry ChaCha20-Poly1305 označeny za zastaralé a Cloudflare je považuje za ukončené (End of Life). Pokud máte klienty, kteří se na tyto šifry aktuálně spoléhají, důrazně doporučujeme přejít na novější a bezpečnější šifry. Mějte na paměti, že tyto zastaralé šifry budou v prvním čtvrtletí roku 2024 zcela odstraněny a požadavky, které je používají, začnou selhávat. Proveďte potřebné kroky včas, aby přechod proběhl hladce a zabezpečení vašich systémů zůstalo zachováno.

Hlavičky Transfer-Encoding a Content-Length

Datum ukončení platnosti: July 1, 2023

Dříve norma RFC 2616 umožňovala použití Transfer-Encoding a Content-Length HTTP hlaviček ve stejném požadavku. RFC 7230 nahrazuje RFC 2616 a zakazuje použití Transfer-Encoding a Content-Length hlavičky ve stejném požadavku, protože mohou způsobit zranitelnosti typu HTTP request smuggling.

Od 1. července 2023 bude Cloudflare odmítat požadavky, které obsahují zároveň Transfer-Encoding a Content-Length HTTP hlaviček.

Fakturační profil účtu, fakturační profil uživatele a historie fakturace uživatele

Datum ukončení platnosti: June 6, 2023

Pro tyto endpointy neexistuje žádná náhrada v API. Jako alternativu se přihlaste do svého účtu Cloudflare a zobrazte si:

• E-mail k fakturám a platbám
• Fakturační předplatné
• Platební údaje fakturačního profilu

Zastaralé API:

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

Load Balancing - notification_email

Datum ukončení platnosti: April 3, 2023

Toto pole je zastaralé a bylo přesunuto do centralizovaná služba oznámení Cloudflare.

notification_email je e-mailová adresa, na kterou se odesílají oznámení o stavu kontroly. Může jít o jednotlivou schránku nebo distribuční seznam. Více e-mailů lze zadat jako seznam oddělený čárkami.

Aplikace Access Bookmark

Datum ukončení platnosti: March 19, 2023

Tento endpoint je zastaralý, místo něj použijte specializované API Access Application App Type.

Zastaralé 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

Náhrada: Access applications app type API

Page Shield

Datum ukončení platnosti: October 11, 2022

Nahraďte script_monitor v trasách API Page Shield s page_shield.

Cloudflare Images - Create authenticated direct upload URL v1

Datum ukončení platnosti: July 1, 2022

Tento endpoint je zastaralý, místo něj použijte v2, které umožňuje řídit metadata, definovat přístupovou politiku a získat ID obrázku.

Zastaralé API: POST accounts/:account_identifier/images/v1/direct_upload

Náhrada: POST accounts/:account_identifier/images/v2/direct_upload

Zone Analytics API

Datum ukončení platnosti: March 1, 2021

Toto API je zastaralé a je nahrazeno GraphQL Analytics API, která poskytuje rovnocenná data a další funkce, včetně možnosti vybrat pouze metriky, které potřebujete. Další informace naleznete v Průvodce migrací z analytiky zóny na analytiku GraphQL.

Zastaralé API:

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

Náhrada: GraphQL Analytics API

Organizations

Datum ukončení platnosti: April 2, 2020

Tento endpoint a související API jsou zastaralé a jsou nahrazeny /accounts ekvivalentní API, které nabízí širší funkce a je zpětně kompatibilní s /organizations API.

Zastaralé 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

Náhrada: Accounts API