Documentación de uso de cURL

cURL es una herramienta de línea de comandos y biblioteca utilizada para transferir datos. Admite varios protocolos, como HTTP, HTTPS, FTP, entre otros. cURL es muy útil en el desarrollo web, especialmente para realizar solicitudes HTTP, descargas de archivos y llamadas a API. ServBay ya incluye cURL de fábrica, este artículo proporcionará una guía detallada sobre la instalación, configuración y uso de cURL.

Tabla de contenidos

• Tabla de contenidos
• Instalación y configuración
  • Instalación
  • Configuración
• Uso básico
  • Enviar solicitud HTTP GET
  • Enviar solicitud HTTP POST
  • Descargar archivos
  • Subir archivos
• Uso avanzado
  • Configurar encabezados HTTP
  • Manejo de datos JSON
  • Manejo de Cookies
  • Usar proxy
  • Limitar el ancho de banda
  • Reanudar descargas
  • Verificar certificados SSL
• Problemas comunes
  • 1. El comando cURL no funciona
  • 2. Error al enviar la solicitud
  • 3. Error al descargar o subir archivos
  • 4. Falló la verificación del certificado SSL
• Conclusión

Instalación y configuración

Instalación

ServBay ya incluye cURL de fábrica, no se requiere instalación adicional.

Configuración

No se requiere configuración por defecto.

Uso básico

cURL ofrece una amplia gama de opciones de línea de comandos para diversas tareas de transferencia de datos. A continuación se presentan algunos ejemplos básicos de uso:

Enviar solicitud HTTP GET

curl -X GET https://api.example.com/data

Enviar solicitud HTTP POST

curl -X POST -d "param1=value1&param2=value2" https://api.example.com/data

Descargar archivos

curl -O https://example.com/file.zip

Subir archivos

curl -X POST -F "file=@/path/to/file" https://api.example.com/upload

Uso avanzado

Configurar encabezados HTTP

curl -H "Content-Type: application/json" -H "Authorization: Bearer token" https://api.example.com/data

Manejo de datos JSON

Enviar datos JSON

curl -X POST -H "Content-Type: application/json" -d '{"key1":"value1", "key2":"value2"}' https://api.example.com/data

Obtener y analizar respuesta JSON (junto con jq)

curl -s https://api.example.com/data | jq .

Manejo de Cookies

Guardar cookies en un archivo

curl -c cookies.txt https://example.com

Usar archivo de cookies

curl -b cookies.txt https://example.com

Usar proxy

curl -x http://proxy.example.com:8080 https://api.example.com/data

Limitar el ancho de banda

curl --limit-rate 100K https://example.com/file.zip -O

Reanudar descargas

curl -C - -O https://example.com/largefile.zip

Verificar certificados SSL

curl --cacert /path/to/ca-bundle.crt https://secure.example.com

Problemas comunes

1. El comando cURL no funciona

• Solución: Verifique si cURL está instalado correctamente y asegúrese de que la ruta del archivo de configuración sea correcta. Si el problema persiste, consulte los registros de errores para obtener más información.

2. Error al enviar la solicitud

• Solución: Verifique que la URL y los parámetros de la solicitud sean correctos. Asegúrese de que la conexión a la red sea estable y que el servidor de destino sea accesible.

3. Error al descargar o subir archivos

• Solución: Verifique que la ruta del archivo y los permisos sean los correctos. Asegúrese de que el servidor de destino admita la operación de transferencia de archivos correspondiente.

4. Falló la verificación del certificado SSL

• Solución: Asegúrese de usar el archivo de certificado CA correcto. Puede usar la opción --insecure para omitir la verificación del certificado SSL (no recomendado para entornos de producción).

curl --insecure https://secure.example.com

Conclusión

cURL es una herramienta de línea de comandos potente y flexible, adecuada para diversas tareas de transferencia de datos. Con esta guía, puedes aprender a instalar, configurar y usar cURL en ServBay para realizar solicitudes HTTP, descargar archivos y hacer llamadas a API.