ES 
EN 
RU 
DE 
CN 
VI 
PT 
UK 
FR 
TR 
BN 
| Opción cURL | Descripción | Ejemplo de uso |
|---|---|---|
-H, --header | Pasar encabezado(s) personalizado(s) al servidor | curl -H "Header: Value" http://example.com |
-A, --user-agent | Establecer la cadena User-Agent | curl -A "MyAgent" http://example.com |
-e, --referer | Establecer el encabezado Referer | curl -e "http://referrer.com" http://example.com |
-b, --cookie | Enviar cookies desde una cadena o archivo | curl -b "name=value" http://example.com |
-d, --data | Enviar datos en una solicitud POST | curl -d "key=value" http://example.com |
El envío de encabezados HTTP personalizados con cURL es esencial para probar y depurar aplicaciones web. En este artículo, exploraremos cómo enviar encabezados HTTP mediante cURL, una potente herramienta de línea de comandos para transferir datos con URL.
Comprensión de los encabezados HTTP
Los encabezados HTTP son pares clave-valor que se envían en solicitudes y respuestas entre clientes y servidores. Transmiten metainformación sobre la solicitud o la respuesta, como el tipo de contenido, las credenciales de autorización y las directivas de almacenamiento en caché. Los encabezados HTTP más comunes incluyen:
| Nombre del encabezado | Objetivo |
|---|---|
User-Agent | Identifica el software del cliente |
Accept | Especifica los tipos de contenido aceptables |
Authorization | Contiene credenciales para autenticación. |
Content-Type | Indica el tipo de medio del recurso. |
Referer | La dirección de la página web anterior |
¿Por qué enviar encabezados HTTP personalizados con cURL?
Los encabezados HTTP personalizados le permiten:
- Simular solicitudes desde diferentes navegadores o dispositivos.
- Pruebe las API que requieren encabezados específicos.
- Depure problemas modificando los encabezados.
- Controlar el almacenamiento en caché y la negociación de contenido.
- Autenticar solicitudes a recursos protegidos.
Envío de encabezados HTTP con cURL
Usando el -H o --header Opción
Para enviar un encabezado HTTP personalizado con cURL, utilice el -H o --header Opción seguida del encabezado:
curl -H "Header-Name: Header-Value" http://example.com
Encabezados múltiples
Puede enviar varios encabezados especificando varios -H Opciones:
curl -H "First-Header: Value1" -H "Second-Header: Value2" http://example.com
Reemplazar o modificar encabezados predeterminados
cURL envía automáticamente ciertos encabezados como Host y User-AgentPara reemplazar un encabezado predeterminado, especifíquelo con un nuevo valor. Por ejemplo, para cambiar el User-Agent:
curl -H "User-Agent: MyCustomAgent" http://example.com
Si desea eliminar un encabezado, configúrelo como una cadena vacía:
curl -H "Accept:" http://example.com
Ejemplos de envío de encabezados HTTP con cURL
Ejemplo: Configuración del agente de usuario
El User-Agent El encabezado identifica el software del cliente. Para configurarlo:
curl -H "User-Agent: Mozilla/5.0" http://example.com
Alternativamente, puede utilizar el -A opción:
curl -A "Mozilla/5.0" http://example.com
Ejemplo: Agregar encabezado de autorización
Para las API que requieren autenticación, es posible que deba enviar un Authorization encabezamiento:
curl -H "Authorization: Bearer your_token_here" http://api.example.com
Ejemplo: Configuración del tipo de contenido para solicitudes POST
Al enviar datos en una solicitud POST, es posible que deba especificar el Content-Type encabezamiento:
curl -d '{"key":"value"}' -H "Content-Type: application/json" http://example.com/api
Ejemplo: uso de encabezados personalizados con servidores proxy
Si utiliza un proxy para enviar sus solicitudes, puede combinar opciones de proxy con encabezados personalizados:
curl -x http://proxyelite.info:8080 -H "Custom-Header: Value" http://example.com
Consejos y mejores prácticas
- Encierre los encabezados entre comillas:Siempre encierre los valores del encabezado entre comillas para evitar la interpretación del shell, especialmente cuando contienen espacios o caracteres especiales.
- Modo verboso:Utilice el modo verboso
-vPara ver los encabezados enviados y recibidos. Esto es útil para depurar:
curl -v -H "Header: Value" http://example.com
- Informacion delicada:Tenga cuidado al enviar datos confidenciales en los encabezados, especialmente al compartir ejemplos de comandos o registros.
- Encabezados predeterminados: Recuerde que cURL envía algunos encabezados predeterminados. Si los sobrescribe, puede afectar la respuesta del servidor.
Errores comunes que se deben evitar
- Citas faltantes:Olvidar las comillas alrededor de los encabezados puede provocar errores o comportamientos inesperados.
- Sintaxis de encabezado incorrecta:Los encabezados deben tener el formato
Header-Name: Value. - Sensibilidad entre mayúsculas y minúsculas:Si bien los nombres de encabezado no distinguen entre mayúsculas y minúsculas, se recomienda utilizar la capitalización estándar.
Conclusión
Enviar encabezados HTTP con cURL es sencillo y eficaz. Ya sea que estés probando API o simulando diferentes clientes, dominar las opciones de encabezado de cURL mejora tu capacidad para interactuar con servidores web de manera efectiva.