Cuándo utilizar curl
Utilice curl para inspeccionar las respuestas de HTTP, descargar un recurso o llamar a un API desde el servidor. Separe el éxito del transporte del éxito de la aplicación, establezca tiempos de espera razonables y mantenga los tokens de autenticación fuera de los ejemplos de comandos guardados.
Sintaxis
curl [PARAMETERS] URLLos corchetes marcan argumentos opcionales; una elipsis significa repetición. Reemplace los nombres de archivos de ejemplo, nombres de usuarios y direcciones de servidores con sus propios valores.
Opciones y argumentos comunes
Ejemplos de uso
Verifique los encabezados del sitio
curl -I https://example.comSe realiza una solicitud de solo encabezado; algunos servicios manejan esto de manera diferente a una solicitud de contenido normal.
Descargar archivo con procesamiento de errores HTTP
curl --fail --location --output ./page.html https://example.comSe siguen las redirecciones y el cuerpo de la respuesta reemplaza el archivo local nombrado; Los estados de error HTTP provocan fallos.
Solicitar JSON con límite de tiempo
curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/statusSe solicita una respuesta JSON con una duración global limitada; el punto final debe proporcionar realmente ese API.
Notas y limitaciones
- Con HTTPS el certificado se verifica por defecto; No desactive la verificación a través de -k sin un motivo específico.
- No coloque tokens o contraseñas reales en el historial de comandos y no ejecute scripts descargados sin verificación.
Preguntas comunes y solución de problemas
¿Por qué curl tiene éxito cuando el servidor devuelve una página de error?
Sin la opción de error, recibir una respuesta de error HTTP aún puede contar como una transferencia exitosa. Inspeccione tanto el estado de HTTP como el estado de salida del comando.
¿Debo desactivar la verificación del certificado para solucionar HTTPS?
No pase por alto la confianza como una solución de rutina. En su lugar, verifique el nombre de host, la hora del sistema, la cadena de certificados del servidor y la configuración de CA confiable.
Más ayuda
Las opciones varían según la versión y la distribución. Consulta la documentación instalada con este comando: man curl.