Конвертувати curl у HTTP

Сирий HTTP показує фактичний текст протоколу, надісланий по мережі: рядок запиту (GET /path HTTP/1.1), заголовки та тіло. Це канонічне представлення, визначене в RFC 9110. curl2code генерує сирий формат HTTP-запиту, що корисно для розуміння того, що саме робить команда curl на рівні протоколу.

Сирий HTTP показує точне представлення протоколу — найкраще для навчання та документації. HAR структурований у JSON для інструментів. HTTPie — це зручний для людини синтаксис CLI. Обирайте сирий HTTP для розуміння протоколу, HAR для аналізу, HTTPie для скриптів. Див. також curl до HAR та curl до HTTPie.

Автентифікація виглядає як рядок заголовка: Authorization: Bearer token123 або Authorization: Basic dXNlcjpwYXNz. У сирому HTTP ви бачите точний заголовок, який надсилається, що дозволяє легко перевірити правильність налаштування автентифікації. curl2code показує повний запит, включаючи заголовки автентифікації.

Дані форми multipart показують розділювач (boundary), кожну частину з власними заголовками Content-Disposition та Content-Type, розділеними рядками boundary. Заголовок Content-Type містить multipart/form-data; boundary=.... Сирий HTTP розкриває точну структуру, яку бібліотеки зазвичай приховують.

Рядок статусу відповіді показує код: HTTP/1.1 404 Not Found або HTTP/1.1 500 Internal Server Error. Заголовки відповіді можуть містити Retry-After для обмеження частоти запитів або WWW-Authenticate для запитів автентифікації. Розуміння сирого HTTP допомагає налагоджувати проблеми в будь-якій мові програмування.

HTTP/1.1 використовує текстові заголовки та один запит на з'єднання (з keep-alive). HTTP/2 мультиплексує запити через одне бінарне з'єднання. HTTP/3 використовує QUIC (на базі UDP) для швидшого встановлення з'єднання. curl підтримує всі три версії з прапорцями --http2 та --http3.

200 OK, 201 Created, 204 No Content — успіх. 301/302 — перенаправлення. 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found — помилки клієнта. 500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable — помилки сервера. 429 Too Many Requests — перевищено ліміт запитів.

Порівняйте сирий вивід HTTP від curl2code з реальним мережевим трафіком (використовуйте curl -v для детального виводу). Перевірте, чи відповідають заголовки, Content-Type, кодування тіла та Content-Length очікуванням. Інструменти на кшталт mitmproxy, Wireshark та Fiddler показують сирий HTTP для будь-якого клієнта. Для налагодження в CLI див. curl до HTTPie.

Використовуйте команду curl -X POST -d '{"key":"value"}' -H "Content-Type: application/json", і curl2code конвертує її у формат Raw HTTP: POST /api/data HTTP/1.1 Content-Type: application/json {'key':'value'}. Тіло JSON і заголовок Content-Type зберігаються у виводі. curl2code підтримує як вбудований JSON, так і посилання на @file.json.

Коли ви конвертуєте curl -H "Authorization: Bearer YOUR_TOKEN" URL за допомогою curl2code, Bearer-токен зберігається у виводі Raw HTTP: Authorization: Bearer YOUR_TOKEN. Як прапорці -H "Authorization: Bearer ...", так і прапорці OAuth-токенів виявляються автоматично.

При конвертації curl -H "Content-Type: application/json" URL curl2code виводить Content-Type в Raw HTTP як: Content-Type: application/json. Поширені типи включають application/json, application/x-www-form-urlencoded та multipart/form-data. curl2code зберігає точний Content-Type з оригінальної команди curl.