Τι κάνει;

Ο Μετατροπέας cURL σε κώδικα μετατρέπει μια εντολή curl σε κώδικα που στέλνει το ίδιο HTTP αίτημα από το δικό σας πρόγραμμα. Παράγει τρία είδη κώδικα:

  • JavaScript (fetch): το API fetch που είναι ενσωματωμένο στα προγράμματα περιήγησης, στο Deno, στο Bun και στο Node.js.
  • Node.js (Axios): τη δημοφιλή βιβλιοθήκη Axios, με λειτουργικές μονάδες Node.js για αρχεία και ρυθμίσεις TLS.
  • Python (Requests): τη βιβλιοθήκη Requests.

Ένας συνηθισμένος τρόπος για να λάβετε μια εντολή είναι μέσω των εργαλείων προγραμματιστών του προγράμματος περιήγησής σας: στο πλαίσιο «Δίκτυο», κάντε δεξί κλικ σε ένα αίτημα και επιλέξτε «Αντιγραφή ως cURL». Τα παραδείγματα στην τεκμηρίωση API εμφανίζονται συχνά επίσης ως εντολές curl.

Πώς να το χρησιμοποιήσετε

  1. Επικολλήστε την εντολή curl. Οι μεγάλες εντολές μπορούν να εκτείνονται σε πολλές γραμμές, με ανάστροφη κάθετο στο τέλος κάθε γραμμής, όπως απαιτούν τα shell.
  2. Επιλέξτε τη γλώσσα.
  3. Αντιγράψτε τον κώδικα ή κατεβάστε τον ως αρχείο (request.mjs για JavaScript, request.py για Python).

Ο κώδικας ενημερώνεται καθώς πληκτρολογείτε. Αν η εντολή περιέχει σφάλμα που θα εμπόδιζε τη λειτουργία του ίδιου του curl, όπως ένα εισαγωγικό που δεν κλείνει ή μια άγνωστη επιλογή, το εργαλείο επισημαίνει το πρόβλημα.

Τι μετατρέπεται

  • Η μέθοδος, συμπεριλαμβανομένων των μεθόδων που επιλέγει αυτόματα το curl: τα -d και -F ορίζουν μέθοδο POST, το -I μέθοδο HEAD και το -T μέθοδο PUT.
  • Η URL, μαζί με τυχόν παραμέτρους ερωτήματος που προσθέτει το -G ή το --url-query.
  • Οι κεφαλίδες από το -H, ο user agent από το -A, ο παραπέμπων από το -e και τα cookies από το -b, τα οποία γίνονται λεξικό cookies στην Python.
  • Ο βασικός έλεγχος ταυτότητας από το -u ή από την URL, με τον τρόπο αποστολής που χρησιμοποιεί κάθε βιβλιοθήκη, καθώς και τα Bearer token από το --oauth2-bearer. Στην Python υποστηρίζεται επίσης έλεγχος ταυτότητας Digest.
  • Τα σώματα αιτημάτων: τα JSON από το --json ή από έναν τύπο περιεχομένου JSON γίνονται αντικείμενο ή λεξικό, τα δεδομένα φόρμας από το -d γίνονται URLSearchParams ή λεξικό και οι φόρμες πολλαπλών τμημάτων από το -F γίνονται FormData ή λεξικό files, συμπεριλαμβανομένων των μεταφορτώσεων αρχείων.
  • Το χρονικό όριο από το --max-time (και το --connect-timeout στην Python), το -k για παράλειψη των ελέγχων TLS, τα πιστοποιητικά CA και πελάτη, καθώς και ένας διακομιστής μεσολάβησης από το -x.

Οι κεφαλίδες που προσθέτει το ίδιο το curl, όπως ο δικός του User-Agent, το Accept: */* και το Content-Length, παραλείπονται, καθώς οι βιβλιοθήκες στέλνουν τις δικές τους. Παραλείπονται επίσης οι επιλογές που αλλάζουν μόνο τον τρόπο εμφάνισης της απόκρισης από το curl, όπως οι -s ή -v.

Όταν κάτι δεν μπορεί να μετατραπεί

Ορισμένα στοιχεία δεν έχουν αντίστοιχο σε κάποια βιβλιοθήκη ή γλώσσα. Αυτά εμφανίζονται ως σχόλια στην αρχή του κώδικα, ώστε να μη χάνεται τίποτα χωρίς ενημέρωση:

  • Οι επιλογές χωρίς αντίστοιχο, όπως η --retry, παρατίθενται ως «Δεν μετατράπηκε».
  • Το fetch δεν μπορεί να παραλείψει τους ελέγχους TLS, να χρησιμοποιήσει διακομιστή μεσολάβησης ή να ορίσει χρονικό όριο σύνδεσης. Επίσης, τα προγράμματα περιήγησης δεν επιτρέπουν στα σενάρια να ορίζουν την κεφαλίδα Cookie, σε αντίθεση με το Node.js.
  • Τα αρχεία που διαβάζει το curl, όπως τα -d @data.json ή -F photo=@cat.jpg, διαβάζονται από τον δίσκο στο Node.js και στην Python. Στην JavaScript του προγράμματος περιήγησης εμφανίζονται ως σύμβολα κράτησης θέσης που πρέπει να αντικαταστήσετε, για παράδειγμα με ένα αρχείο από ένα <input type="file">.
  • Αν μια εντολή στέλνει πολλά αιτήματα, ο κώδικας αφορά το πρώτο.

Παραδείγματα

  • Η εντολή curl https://example.com/ γίνεται requests.get("https://example.com/") στην Python.
  • Η εντολή curl -u ada:secret https://api.example.com/me γίνεται auth=("ada", "secret") στην Python και επιλογή auth στο Axios.
  • Η εντολή curl --json '{"item": "sourdough loaf"}' https://api.example.com/orders γίνεται json={"item": "sourdough loaf"} στην Python και JSON.stringify({ item: "sourdough loaf" }) με το fetch.

Πώς λειτουργεί

Η εντολή διαβάζεται όπως θα τη διάβαζαν ένα shell και το curl, με εισαγωγικά, χαρακτήρες διαφυγής και συνέχιση γραμμών, από τον ίδιο αναλυτή που χρησιμοποιεί ο Επικυρωτής εντολών cURL του ιστότοπου. Στη συνέχεια, το αίτημα που θα έστελνε το curl αποδίδεται ως κώδικας. Όλα γίνονται στο πρόγραμμα περιήγησής σας, επομένως οι εντολές με token ή κωδικούς πρόσβασης δεν φεύγουν ποτέ από τη συσκευή σας.

Χαρακτηριστικά

  • JavaScript fetch, Node.js Axios και Python Requests
  • Κεφαλίδες, cookies, βασικός έλεγχος ταυτότητας και έλεγχος ταυτότητας Bearer
  • Σώματα αιτημάτων JSON, φόρμας, πολλαπλών τμημάτων και αρχείων
  • Χρονικά όρια, επιλογές TLS, πιστοποιητικά και διακομιστές μεσολάβησης
  • Σχόλια για οτιδήποτε δεν μπορεί να μετατραπεί
  • Σαφή μηνύματα για σφάλματα στην εντολή
  • Αντιγραφή ή λήψη του κώδικα
  • Εκτελείται στο πρόγραμμα περιήγησής σας