Inicio
» WINDOWS
»
Cómo usar cURL en Windows 10: Comandos esenciales
Cómo usar cURL en Windows 10: Comandos esenciales
Windows 10 incluye curl.exe , por lo que puedes realizar solicitudes web desde PowerShell o el Símbolo del sistema sin necesidad de instalar una herramienta aparte. Abre una terminal, comprueba que se ejecuta y, a continuación, usa cURL con una URL para recuperar una página, inspeccionar los encabezados de respuesta, descargar un archivo o enviar datos a una API. En Windows PowerShell 5.1, escribe curl.exeen lugar de curlpara que PowerShell ejecute el programa cURL real.
Compruebe la versión de cURL instalada antes de utilizar sus opciones.
1. Abre una terminal y comprueba cURL.
Abre el menú Inicio, busca PowerShell o Símbolo del sistema y ejecútalo normalmente. No se requieren permisos de administrador para las solicitudes o descargas habituales a tus carpetas de usuario.
curl.exe --version
La salida incluye la versión instalada y los protocolos y características disponibles en esa compilación. Windows PowerShell 5.1 tiene un alias integrado con el nombre curldel Invoke-WebRequestcomando independiente, por lo que los comandos copiados de tutoriales de Linux pueden comportarse de manera diferente a menos que uses curl.exe. PowerShell 7 no define ese alias. Microsoft documenta esta diferencia en su guía de cURL en Windows .
2. Haz una solicitud básica
Coloca una URL después del comando. cURL usa HTTP GET por defecto y escribe el cuerpo de la respuesta en la terminal:
curl.exe "https://example.com"
Para una página web, la respuesta es HTML; una API puede devolver JSON u otro formato. El comando transfiere la respuesta tal cual, en lugar de renderizarla como lo haría un navegador. Si una URL contiene caracteres como &o ?, mantenga la URL completa entre comillas para que el intérprete de comandos la pase como un argumento.
Una solicitud cURL básica imprime la respuesta del servidor en la terminal.
3. Comprobar los encabezados de respuesta
Utilice mayúsculas -Ipara enviar una solicitud HEAD y mostrar los encabezados de respuesta sin descargar el cuerpo:
curl.exe -I "https://example.com"
Los encabezados pueden mostrar el estado HTTP, el tipo de contenido, los detalles de almacenamiento en caché y otros metadatos del servidor. Algunos servicios no admiten HEAD o devuelven un resultado diferente para este que para GET. Para incluir encabezados con una respuesta GET normal, use minúsculas -i. Use -Lcuando el servidor redirige la solicitud y desea que cURL siga esa redirección.
La opción -I solicita al servidor únicamente los encabezados de respuesta.
4. Guarda una respuesta en un archivo.
Por defecto, cURL imprime los datos de respuesta en la terminal. Utilice esta opción -opara elegir un nombre de archivo y una ubicación. Este ejemplo de PowerShell escribe una respuesta HTML en su carpeta de Descargas:
-Lsigue las redirecciones, mientras que -onombra el archivo de salida. El comando sobrescribe un archivo con el mismo nombre, así que elija un destino con cuidado. Para guardar en la carpeta actual, use curl.exe -L -o "example.html" "https://example.com". La -Oopción (letra O mayúscula) usa el nombre del archivo de la URL:
La segunda URL es un formato de ejemplo; sustitúyala por una URL de archivo directa que exista y que usted tenga autorización para descargar.
La opción -o escribe la respuesta en un archivo con nombre.
5. Enviar JSON a una API
Para una solicitud POST en formato JSON, especifique el método, el tipo de contenido y el cuerpo de la solicitud. Reemplace el punto final de ejemplo con la URL de su propia API:
curl.exe -X POST "https://api.example.com/items" -H "Content-Type: application/json" -d '{"name":"widget"}'
-X POSTSelecciona el método HTTP, -Hagrega una cabecera y -dproporciona el cuerpo. El servidor debe aceptar solicitudes POST y los campos JSON deben coincidir con su API. No pegues contraseñas, tokens privados ni otros secretos en un comando si tu historial de terminal o los registros compartidos pueden exponerlos. El manual oficial de cURL enumera estas opciones y sus requisitos de versión.
Solucionar problemas comunes
“curl no se reconoce”. Ejecútalo where.exe curlen PowerShell o Símbolo del sistema. En Windows 10, la copia de Microsoft normalmente está disponible como C:\Windows\System32\curl.exe. Si falta el ejecutable en una instalación personalizada, descarga una compilación para Windows desde la página oficial de cURL para Windows , elige el paquete para tu sistema y ejecútalo curl.exedesde su carpeta extraída. Agrega esa carpeta a PATH solo si quieres ejecutarlo desde cualquier directorio.
PowerShell dice que un parámetro no es válido. Asegúrese de que el comando comience con curl.exe. En Windows PowerShell 5.1, curles posible que se llame a plain Invoke-WebRequesten su lugar.
Se produjo un error en la solicitud debido a un fallo en el certificado HTTPS. Compruebe la fecha y la hora del equipo, actualice Windows y verifique si un servidor proxy o un producto de seguridad requiere un certificado de confianza. Evite usar esta -ksolución de forma rutinaria, ya que desactiva la verificación del certificado.
Windows 10 aún ejecuta cURL, pero Microsoft finalizó el soporte para Windows 10 el 14 de octubre de 2025. Los dispositivos que no forman parte de un programa de actualización de seguridad aplicable ya no reciben correcciones de seguridad periódicas; consulte el aviso de soporte de Microsoft para Windows 10 .