Lección 1
Leer comandos cURL
Identifica URL, método, headers, flags de cuerpo y comillas del shell antes de convertir.
Un comando cURL es tanto una petición HTTP como un comando de shell. Antes de convertirlo, separa esas dos capas.
curl -X POST "https://api.example.com/users" \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Ada"}'
La petición HTTP contiene:
- Método:
POST - URL:
https://api.example.com/users - Headers:
Authorization,Content-Type - Cuerpo:
{"name":"Ada"}
La capa de shell contiene comillas, continuaciones de línea y reglas de escape.
Ubicación de la URL
La URL puede aparecer al final, cerca del principio o después de --url:
curl --url "https://api.example.com/search?q=json"
Un conversor debe identificar la URL de la petición en lugar de asumir que siempre es el último token.
Las comillas importan
Las comillas simples, dobles y las barras invertidas son interpretadas por el shell antes de que cURL reciba los argumentos. Un comando copiado de documentación puede estar escrito para Bash, zsh, PowerShell o CMD. La conversión debe preservar los valores HTTP previstos, no los caracteres de comilla literales.
Los flags de cuerpo cambian los valores predeterminados
Cuando cURL ve -d, la petición suele convertirse en POST a menos que se especifique otro método. Ese valor predeterminado puede sorprender a desarrolladores que esperaban GET.
Lee el comando en dos pasadas: primero como sintaxis de shell, luego como petición HTTP. La conversión se vuelve más segura cuando esas capas no se mezclan.