Borrar un archivo de la cache de Cloudflare con un batch y CURL

Comparto el código de un archivo batch, que empleo cada vez que necesito eliminar un archivo cacheado por Cloudflare.
Los que usamos este servicio en un blog o sitio web, cada vez que modificamos una imagen u otro archivo estático, necesitamos eliminar su copia cacheada en las diferentes bases de datos del servicio, para que se actualice correctamente en el navegador del usuario.
Para eso se necesita acceder al panel de control y limpiar la cache del archivo manualmente.
Una alternativa mucho más rápida y sencilla, es la que propongo en este artículo, un script o archivo batch que mediante CURL envía la instrucción necesaria con solo dos clics.

Eliminar un archivo de Cloudflare mediante la API

El método que explico emplea la API que proporciona Cloudflare.
Permite aclarar la cache de cualquier archivo en Cloudflare, que puede ser una imagen o foto, un archivo CSS, JavaScript o cualquier otro archivo estático.
Para usarla se necesita crear una cuenta de desarrollador y obtener la clave personal (API Key).
La petición tiene que realizarse por HTTPS y estar formateada en JSON.
Es necesario previamente descargar el ejecutable de CURL para Windows desde el sitio de su desarrollador en https://curl.haxx.se/ y situarlo en el interior de la carpeta en la que estará el archivo batch que crearemos.
Los que poseen la versión de Windows 1803 u otra superior, no necesitan descargar el ejecutable de CURL, porque está incluido en el sistema operativo.
Lee más información.

Obtener el identificador de la zona en Cloudflare

El primer paso para poder usar la API es obtener el identificador de la zona (ID).
Para eso es necesario hacer la petición con CURL de nuestros datos de usuario.
Abre una ventana de la consola e introduce lo siguiente:

curl -k -X GET "https://api.cloudflare.com/client/v4/zones" -H "X-Auth-Email: usuario2@email.com" -H "X-Auth-Key: XXXXX" -H "Content-Type: application/json" 

Sustituye los siguientes datos:
De la respuesta recibida en la misma ventana en formato JSON, extrae el valor ID que posee 32 caracteres.

Archivo batch para limpiar la cache de un archivo en Cloudflare

Finalmente crea el archivo batch con el siguiente código.

@echo off
SET/p ruta=Escribe o pega la URL del archivo:
echo.
echo.
curl -k -X DELETE "https://api.cloudflare.com/client/v4/zones/ID/purge_cache" -H "X-Auth-Email: usuario2@email.com" -H "X-Auth-Key: XXXXX" -H "Content-Type: application/json" --data "{\"files\":[\"%ruta%\"]}"
echo.
echo.
PAUSE	 

Sitúa el archivo creado en cualquier ubicación, por ejemplo el Escritorio.
Después de ejecutarlo, pega en la ventana de la Consola o Símbolo del sistema la URL del archivo a eliminar de la cache y presiona la tecla Enter.
En el mensaje recibido cerciórate de haber tenido éxito.

Archivo batch para limpiar toda la cache en Cloudflare

De forma similar se puede crear un archivo para borrar la cache completa del sitio, usando el siguiente código:

@echo off
curl -k -X DELETE "https://api.cloudflare.com/client/v4/zones/1ea8c116521c1e23ffb11bc300746045/purge_cache" -H "X-Auth-Email: usuario2@email.com" -H "X-Auth-Key: XXXXX" -H "Content-Type: application/json" --data "{\"purge_everything\":true}"
PAUSE

La instrucción PAUSE usada en ambos casos, solo tiene como objetivo dejar abierta la ventana de la consola al terminar, para comprobar el resultado.

Conocer si CURL está incluido en Windows y su versión

Los que deseen conocer si CURL está incluido en su versión de Windows, solo necesitan abrir una ventana del Símbolo del sistema e introducir la siguiente instrucción:
CURL –V
A continuación presionar Enter.
- Windows 1809 incluye la versión 7.55
- Windows 1909 hasta 2004 incluye la versión 7.55.1
Protocols: dict file ftp ftps http https imap imaps pop3 pop3s smtp smtps telnet tftp

Descargar CURL para Windows

Las versiones de CURL para Windows 64 y 32 bits se pueden descargar desde: https://curl.haxx.se/windows/
Descomprime el archivo descargado y copia los archivos situados en la carpeta bin a C:\Windows\System32

Otros usos prácticos de CURL en redes

CURL es una aplicación que solo funciona mediante la línea de comandos, pero que nos permite realizar infinidad de tareas prácticas y facilita muchas de ellas que de otra forma, son engorrosas.
Con CURL se puede obtener información, subir o descargar archivos, etc.
En otro artículo incluyo varios ejemplos prácticos de su uso.

Páginas relacionadas

Comparta esta página

Sígueme en las redes sociales