Konwerter cURL na kod
Przekształć polecenie curl w kod JavaScript fetch, Axios lub Python Requests, zachowując tę samą metodę, nagłówki, cookies, uwierzytelnianie i treść żądania. Działa w przeglądarce.
Wejście
Wyjście
Instrukcja
Do czego służy?
Konwerter cURL na kod zamienia polecenie curl na kod, który wysyła takie samo żądanie HTTP z poziomu Twojego programu. Generuje trzy rodzaje kodu:
- JavaScript (fetch): interfejs API fetch wbudowany w przeglądarki, Deno, Bun i Node.js.
- Node.js (Axios): popularna biblioteka Axios z modułami Node.js do obsługi plików i ustawień TLS.
- Python (Requests): biblioteka Requests.
Polecenie można często uzyskać w narzędziach deweloperskich przeglądarki: w panelu Sieć kliknij żądanie prawym przyciskiem myszy i wybierz opcję Kopiuj jako cURL. Dokumentacja API również często zawiera przykłady w postaci poleceń curl.
Jak używać
- Wklej polecenie curl. Długie polecenia mogą być podzielone na kilka wierszy — zgodnie z oczekiwaniami powłok umieść ukośnik odwrotny na końcu każdego wiersza.
- Wybierz język.
- Skopiuj kod lub pobierz go jako plik (
request.mjsdla JavaScript,request.pydla Python).
Kod aktualizuje się podczas pisania. Jeśli polecenie zawiera błąd, który uniemożliwiłby działanie samego curl, na przykład niedomknięty cudzysłów lub nieznaną opcję, narzędzie wskaże ten problem.
Co jest konwertowane
- Metoda, w tym metody wybierane automatycznie przez curl:
-di-Fustawiają POST,-I— HEAD, a-T— PUT. - URL wraz z parametrami zapytania dodanymi przez
-Glub--url-query. - Nagłówki z
-H, agent użytkownika z-A, adres odsyłający z-eoraz cookies z-b, które w Pythonie trafiają do słownikacookies. - Uwierzytelnianie Basic z
-ulub z URL, realizowane w sposób właściwy dla danej biblioteki, oraz tokeny Bearer z--oauth2-bearer. W Pythonie obsługiwane jest również uwierzytelnianie Digest. - Treść żądania: JSON z
--jsonlub z nagłówka Content-Type wskazującego JSON staje się obiektem lub słownikiem; dane formularza z-dstają sięURLSearchParamslub słownikiem; formularze wieloczęściowe z-Fstają sięFormDatalub słownikiemfiles, razem z przesyłanymi plikami. - Limit czasu z
--max-time(oraz--connect-timeoutw Pythonie), pominięcie weryfikacji TLS za pomocą-k, certyfikaty CA i klienta oraz serwer proxy z-x.
Nagłówki dodawane przez curl, takie jak własny User-Agent, Accept: */* i Content-Length, są pomijane, ponieważ biblioteki wysyłają własne. Pomijane są również opcje zmieniające wyłącznie sposób wyświetlania odpowiedzi przez curl, takie jak -s lub -v.
Gdy nie można czegoś przekonwertować
Niektóre elementy nie mają odpowiednika w bibliotece lub języku. Są dodawane jako komentarze na początku kodu, aby nic nie zostało pominięte bez ostrzeżenia:
- Opcje bez odpowiednika, takie jak
--retry, są wymienione jako „Nie przekonwertowano”. - fetch nie może pomijać weryfikacji TLS, używać serwera proxy ani ustawiać limitu czasu połączenia. Przeglądarki nie pozwalają też skryptom ustawiać nagłówka Cookie, choć Node.js na to pozwala.
- Pliki odczytywane przez curl, takie jak
-d @data.jsonlub-F photo=@cat.jpg, są odczytywane z dysku w Node.js i Pythonie. W JavaScript w przeglądarce pojawiają się jako symbole zastępcze do zastąpienia, na przykład plikiem wybranym za pomocą elementu<input type="file">. - Jeśli polecenie wysyła kilka żądań, wygenerowany kod dotyczy pierwszego z nich.
Przykłady
curl https://example.com/zostaje zamienione w Pythonie narequests.get("https://example.com/").curl -u ada:secret https://api.example.com/mezostaje zamienione w Pythonie naauth=("ada", "secret"), a w Axios na opcjęauth.curl --json '{"item": "sourdough loaf"}' https://api.example.com/orderszostaje zamienione w Pythonie najson={"item": "sourdough loaf"}, a w fetch naJSON.stringify({ item: "sourdough loaf" }).
Jak to działa
Polecenie jest odczytywane tak, jak robią to powłoka i curl — z uwzględnieniem cudzysłowów, znaków ucieczki i kontynuacji wierszy — przy użyciu tego samego parsera co w walidatorze poleceń cURL w tej witrynie. Następnie żądanie, które wysłałby curl, jest zapisywane w postaci kodu. Wszystko odbywa się w przeglądarce, więc polecenia zawierające tokeny lub hasła nigdy nie opuszczają Twojego urządzenia.
Funkcje
- JavaScript fetch, Node.js Axios i Python Requests
- Nagłówki, cookies oraz uwierzytelnianie Basic i Bearer
- JSON, formularze, formularze wieloczęściowe i treść z plikami
- Limity czasu, opcje TLS, certyfikaty i serwery proxy
- Komentarze dotyczące elementów, których nie można przekonwertować
- Czytelne komunikaty o błędach w poleceniu
- Kopiowanie lub pobieranie kodu
- Działa w przeglądarce