Μετατροπή curl σε R

Το httr είναι το πιο δημοφιλές πακέτο HTTP client για την R, σχεδιασμένο για αλληλεπιδράσεις με web APIs. Παρέχει συναρτήσεις όπως GET(), POST(), PUT() με αυτόματο χειρισμό τύπου περιεχομένου και υποστήριξη OAuth. Εγκαταστήστε το με install.packages("httr"). Το curl2code υποστηρίζει επίσης το httr2, τον διάδοχο επόμενης γενιάς.

Το httr είναι σταθερό και ευρέως διαδεδομένο — τα περισσότερα σεμινάρια R το χρησιμοποιούν. Το httr2 είναι η σύγχρονη αντικατάσταση με σύνταξη piped, ενσωματωμένες επαναλήψεις και περιορισμό ρυθμού (rate limiting). Το πακέτο curl είναι ένα low-level wrapper του libcurl. Χρησιμοποιήστε το httr2 για νέα έργα, και το httr για συμβατότητα. Για παρόμοιες ροές εργασίας επιστήμης δεδομένων, δείτε curl σε Python ή curl σε Julia.

Για Bearer: GET(url, add_headers(Authorization = paste("Bearer", token))). Για Basic auth: GET(url, authenticate(user, pass)). Το httr υποστηρίζει επίσης OAuth 1.0 και 2.0 μέσω των oauth1.0_token() και oauth2.0_token(). Το curl2code μετατρέπει το -u και τις παραμέτρους κεφαλίδας σε σύνταξη R.

Χρησιμοποιήστε το POST(url, body = list(file = upload_file("doc.pdf"), desc = "My file"), encode = "multipart"). Το httr χειρίζεται αυτόματα τα multipart boundaries και το Content-Type. Για σώματα JSON, χρησιμοποιήστε encode = "json". Το curl2code μετατρέπει τις παραμέτρους -F στη σύνταξη multipart του httr.

Χρησιμοποιήστε το stop_for_status(response) για να προκαλέσετε σφάλμα σε αποκρίσεις που δεν είναι 2xx, το warn_for_status() για προειδοποιήσεις ή το message_for_status() για μηνύματα. Ελέγξτε την κατάσταση με status_code(response). Περιβάλλετε σε tryCatch() για προγραμματιστικό χειρισμό σφαλμάτων. Το httr2 χρησιμοποιεί το req_error() για παραμετροποιήσιμη συμπεριφορά σφαλμάτων.

Χρησιμοποιήστε το content(response, "parsed") για αυτόματη ανάλυση JSON-σε-λίστα, ή το content(response, "text") με το jsonlite::fromJSON() για περισσότερο έλεγχο. Το jsonlite μετατρέπει το JSON σε R data frames, λίστες και διανύσματα. Για αγωγούς ανάλυσης δεδομένων, διοχετεύστε απευθείας σε tibble ή dplyr.

Χρησιμοποιήστε το GET(url, timeout(30)) για χρονικό όριο 30 δευτερολέπτων. Το httr2 χρησιμοποιεί το req_timeout(req, 30). Για επαναλήψεις στο httr2: req_retry(req, max_tries = 3, backoff = ~ 2). Το httr δεν διαθέτει ενσωματωμένη επανάληψη — χρησιμοποιήστε έναν βρόχο με tryCatch(). Αυτά αντιστοιχούν στην επιλογή --max-time του curl.

Χρησιμοποιήστε το GET(url, use_proxy("proxy", 8080, username, password)). Το httr περιβάλλει τις επιλογές proxy του libcurl. Επίσης σέβεται τις μεταβλητές περιβάλλοντος http_proxy και https_proxy. Για SOCKS proxies, καθορίστε το σχήμα: use_proxy("socks5://proxy:1080"). Το curl2code μετατρέπει τις παραμέτρους -x σε ρυθμίσεις proxy της R.

Μετατρέψτε μια curl POST εντολή όπως curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL σε R χρησιμοποιώντας το curl2code. Ο παραγόμενος κώδικας χρησιμοποιεί POST(url, body = data, encode = 'json'). Το curl2code εντοπίζει αυτόματα τα -d/--data flags με JSON περιεχόμενο και ορίζει την κατάλληλη Content-Type κεφαλίδα στον κώδικα httr.

Περάστε το curl -H "Authorization: Bearer YOUR_TOKEN" URL στο curl2code και αυτό θα δημιουργήσει κώδικα httr με την κεφαλίδα εξουσιοδότησης: add_headers(Authorization = 'Bearer YOUR_TOKEN'). Το curl2code εντοπίζει τα Bearer tokens τόσο από τα -H "Authorization: Bearer ..." όσο και από τα --oauth2-bearer flags. Για Basic auth, χρησιμοποιήστε το -u user:pass.

Το curl2code μετατρέπει το curl -H "Content-Type: application/json" URL σε κώδικα httr με τη σωστή κεφαλίδα: content_type_json(). Για δεδομένα -d, το curl χρησιμοποιεί από προεπιλογή το application/x-www-form-urlencoded· για μεταφορτώσεις φορμών -F, χρησιμοποιεί το multipart/form-data. Το curl2code αντιστοιχίζει το καθένα στο σωστό httr API.