Конвертиране на 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 form данните показват границата (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 команда.