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ć

  1. 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.
  2. Wybierz język.
  3. Skopiuj kod lub pobierz go jako plik (request.mjs dla JavaScript, request.py dla 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: -d i -F ustawiają POST, -I — HEAD, a -T — PUT.
  • URL wraz z parametrami zapytania dodanymi przez -G lub --url-query.
  • Nagłówki z -H, agent użytkownika z -A, adres odsyłający z -e oraz cookies z -b, które w Pythonie trafiają do słownika cookies.
  • Uwierzytelnianie Basic z -u lub 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 --json lub z nagłówka Content-Type wskazującego JSON staje się obiektem lub słownikiem; dane formularza z -d stają się URLSearchParams lub słownikiem; formularze wieloczęściowe z -F stają się FormData lub słownikiem files, razem z przesyłanymi plikami.
  • Limit czasu z --max-time (oraz --connect-timeout w 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.json lub -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 na requests.get("https://example.com/").
  • curl -u ada:secret https://api.example.com/me zostaje zamienione w Pythonie na auth=("ada", "secret"), a w Axios na opcję auth.
  • curl --json '{"item": "sourdough loaf"}' https://api.example.com/orders zostaje zamienione w Pythonie na json={"item": "sourdough loaf"}, a w fetch na JSON.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