Logo de Kodflux - Plataforma de Herramientas SEO y Auditoría Web

Bash / Basico / 4 min

Purgar la caché de Cloudflare vía API con cURL

Vacía la caché de Cloudflare desde la terminal o tu pipeline de deploy con una sola llamada a la API.

Después de un deploy o de cambiar el CSS, la caché de Cloudflare puede seguir sirviendo la versión vieja. En lugar de entrar al panel a purgar a mano, esta llamada a la API vacía la caché desde la terminal o desde tu pipeline de CI/CD. Puedes purgar todo o solo URLs concretas para no perder todo el caché acumulado.

Guía de Implementación Paso a Paso

  1. En Cloudflare ve a My Profile → API Tokens → Create Token.
  2. Usa la plantilla Edit zone o crea un token con el permiso Zone → Cache Purge → Purge.
  3. Copia el token y guárdalo como variable de entorno (nunca lo pegues en el código).
  4. Consigue tu Zone ID en la pestaña Overview de tu dominio.
  5. Exporta las variables en tu terminal: export CF_TOKEN=... y export CF_ZONE=....
  6. Ejecuta el comando de abajo para purgar todo, o usa la variante con files para URLs puntuales.
  7. Añádelo como paso final de tu script de deploy para automatizarlo.
BASH
# Purgar TODA la caché de la zona
curl -s -X POST \
  "https://api.cloudflare.com/client/v4/zones/${CF_ZONE}/purge_cache" \
  -H "Authorization: Bearer ${CF_TOKEN}" \
  -H "Content-Type: application/json" \
  --data '{"purge_everything":true}'

# Purgar solo URLs concretas (más eficiente tras un deploy parcial)
curl -s -X POST \
  "https://api.cloudflare.com/client/v4/zones/${CF_ZONE}/purge_cache" \
  -H "Authorization: Bearer ${CF_TOKEN}" \
  -H "Content-Type: application/json" \
  --data '{"files":["https://tudominio.com/style.css","https://tudominio.com/app.js"]}'

Purgar por files es preferible en producción: mantiene el resto del caché caliente y evita un pico de peticiones al origen. Reserva purge_everything para cambios globales de plantilla.

Buscar en Kodflux