Οι εντολές cURL είναι ένας εξαιρετικός τρόπος μεταφοράς δεδομένων με διευθύνσεις URL. Οι εντολές cURL συνιστώνται για χρήση API από τερματικά γραμμής εντολών. Όχι μόνο μας επιτρέπει να κάνουμε τακτικά αιτήματα, αλλά μπορούμε επίσης να δημοσιεύουμε δεδομένα φορμών, να ελέγχουμε την ταυτότητα των χρηστών, να αποθηκεύουμε απαντήσεις σε αρχεία και άλλες σχετικές λειτουργίες χειρισμού αρχείων. Με απλά λόγια, το curl είναι ένα βοηθητικό πρόγραμμα γραμμής εντολών για τη μεταφορά δεδομένων από ή προς έναν διακομιστή σχεδιασμένο να λειτουργεί χωρίς αλληλεπίδραση με τον χρήστη. Με το curl, μπορείτε να κάνετε λήψη ή να ανεβάσετε δεδομένα χρησιμοποιώντας ένα από τα υποστηριζόμενα πρωτόκολλα, συμπεριλαμβανομένων των HTTP, HTTPS, SCP, SFTP και FTP.

Ωστόσο, μας διευκολύνει επίσης να δοκιμάσουμε RESTfull API.

Χρησιμοποιούνται εντολές cURL

ΠΑΙΡΝΩ

Το απλούστερο και πιο συνηθισμένο αίτημα/λειτουργία που γίνεται με χρήση HTTP είναι να λάβετε μια διεύθυνση URL. Όταν χρησιμοποιούμε αυτήν την εντολή, στέλνουμε ένα αίτημα και ανακτούμε πόρους από μια συγκεκριμένη διεύθυνση URL (ένα έγγραφο στην περίπτωσή μας).

ΘΕΣΗ

Το προεπιλεγμένο αίτημα είναι ένα GET, αλλά εάν έχουμε την απαίτηση να χρησιμοποιήσουμε την ίδια εντολή cURL για την υποβολή δεδομένων φορμών, πρέπει να χρησιμοποιήσουμε αίτημα POST. Επομένως, σε αυτό το άρθρο, θα χρησιμοποιήσουμε την ίδια εντολή POST για να υποβάλουμε περιεχόμενο κειμένου. Λάβετε υπόψη ότι για να δημοσιεύσουμε δεδομένα, χρησιμοποιούμε την παράμετρο -d (ή – data) με την εντολή cURL.

ΒΑΖΩ

Ενδέχεται να βρεθούμε σε μια απαίτηση ενημέρωσης υπαρχόντων δεδομένων, επομένως για το σκοπό αυτό χρησιμοποιείται μια μέθοδος PUT. Για να εκπληρώσουμε αυτήν την απαίτηση, πρέπει να χρησιμοποιήσουμε -X PUT στην εντολή cURL όπου το X πρέπει να είναι με κεφαλαία.

Για περισσότερες πληροφορίες, επισκεφτείτε το cURL tutorial.

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

Ρύθμιση του cURL σε Mac

Σε αυτό το άρθρο, πρόκειται να χρησιμοποιήσουμε εντολές cURL στο macOS για την εισαγωγή και ενημέρωση αντικειμένων του υποσέλιδου κεφαλίδας μέσα στο έγγραφο MS Word χρησιμοποιώντας μια εφαρμογή τερματικού. Για να ξεκινήσετε λοιπόν, το πρώτο πράγμα είναι να εγκαταστήσετε το cURL στο macOS. Ανοίξτε την εφαρμογή Terminal στην κατηγορία Άλλα από το launchpad ή, πατήστε Command+Space και πληκτρολογήστε Terminal και πατήστε το πλήκτρο enter/return. Ο ευκολότερος τρόπος για να εγκαταστήσετε το cURL είναι να χρησιμοποιήσετε το Homebrew και για αυτόν τον λόγο, πρώτα, πρέπει να ρυθμίσετε το homebrew στον υπολογιστή σας Mac. Πληκτρολογήστε την παρακάτω εντολή στο τερματικό της γραμμής εντολών και πατήστε το πλήκτρο Enter.

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null

Τώρα λάβετε το πακέτο παρασκευής για cURL χρησιμοποιώντας την ακόλουθη εντολή.

 brew install curl

Γινώμενος! Τώρα μπορείτε να χρησιμοποιήσετε μπούκλα.

Εξουσιοδότηση λογαριασμού Aspose.Cloud

Για να ξεκινήσετε με τα APIs Aspose.Cloud, το πρώτο βήμα είναι να ελέγξετε την ταυτότητα του λογαριασμού σας και να λάβετε JWT ως απόκριση. Εάν δεν έχετε λογαριασμό, μπορείτε να δημιουργήσετε έναν στο Aspose.Cloud dashboard ή να εγγραφείτε μέσω του υπάρχοντος λογαριασμού σας Google ή GitHub και να αρχίσετε να χρησιμοποιείτε τα API Cloud μας.

// First get JSON Web Token for authentication
// Get App Key and App SID from https://dashboard.aspose.cloud/
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Aspose.Words Cloud

Το Aspose προσφέρει API για χειρισμό εγγράφων MS Word και έχετε την επιλογή είτε να χρησιμοποιήσετε API Cloud, APIs On-Premise είτε Εφαρμογές μεταξύ πλατφορμών για την επεξεργασία εγγράφων του Word. Σε αυτό το ιστολόγιο, έχουμε δώσει έμφαση στα API Cloud που μας παρέχουν τις δυνατότητες δημιουργίας, χειρισμού και μετατροπής εγγράφων MS Word στο Cloud. Δεν απαιτείται λήψη ή εγκατάσταση συγκεκριμένου λογισμικού για την εργασία με αρχεία MS Word.

Η οικογένεια προϊόντων Aspose.Cloud παρέχει ένα σύνολο από SDK cloud που στοχεύουν δημοφιλείς γλώσσες προγραμματισμού, συμπεριλαμβανομένων των .NET, Java, PHP, Python, Node.js, Android, C++, 6 Ruby. Όλα αυτά τα SDK αποτελούν ένα περιτύλιγμα γύρω από το Aspose.Words Cloud REST API και οι εντολές cURL είναι ένας από τους απλούστερους και ευκολότερους τρόπους πρόσβασης στα API REST μέσω της γραμμής εντολών/τερματικό.

Σε αυτό το ιστολόγιο, δίνουμε έμφαση στη χρήση εντολών cURL για τον χειρισμό της ενότητας Κεφαλίδα και Υποσέλιδο μέσα στα αρχεία του MS Word κατά την πρόσβαση στο Aspose.Words Cloud API.

Ανεβάστε έγγραφο του Word

Μόλις ολοκληρωθεί ο έλεγχος ταυτότητας, το επόμενο βήμα είναι να ανεβάσετε το αρχείο στο χώρο αποθήκευσης cloud. Χρησιμοποιώντας την ακόλουθη εντολή cURL, το αρχείο μεταφορτώνεται στον προεπιλεγμένο χώρο αποθήκευσης στο InputFolder.

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/InputFolder" \
-H "accept: application/json" \
-H "authorization: Bearer <jwt token>" \
-F document=@BusinessLetter2.docx
Έξοδος κονσόλας κατά τη μεταφόρτωση του αρχείου στο Cloud Storage

Μήνυμα επιτυχίας κατά τη μεταφόρτωση ενός αρχείου στο χώρο αποθήκευσης cloud.

Τώρα, για να επιβεβαιώσετε την παρουσία του αρχείου στο χώρο αποθήκευσης στο cloud, ανοίξτε την καρτέλα Τα Αρχεία μου στο dashboard.aspose.cloud, μπορούμε να παρατηρήσουμε ότι ένας νέος φάκελος με το όνομα InputFolder που περιέχει το BusinessLetter2.docx εμφανίζεται στη λίστα.

Φάκελος και αρχείο που δημιουργήθηκε πρόσφατα ανέβηκε στο Cloud Storage

Εισαγωγή αντικειμένου κεφαλίδας

Μετά τη μεταφόρτωση του εγγράφου, μπορούμε είτε να εισαγάγουμε ένα νέο αντικείμενο κεφαλίδας ή υποσέλιδου είτε να αποκτήσουμε πρόσβαση σε ένα υπάρχον αντικείμενο και να ενημερώσουμε τις ιδιότητές του. Επί του παρόντος, το Aspose.Words Cloud API υποστηρίζει τους ακόλουθους τύπους αντικειμένων Header και Footer.

Η ακόλουθη εντολή δείχνει πώς να εισαγάγετε το αντικείμενο HeaderFirst μέσα στο έγγραφο του Word που είναι ήδη διαθέσιμο στο χώρο αποθήκευσης Cloud στον φάκελο InputFolder.

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/headersfooters?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "'HeaderFirst'" \
-H "Content-Type: application/json"

Μόλις εκτελεστεί η παραπάνω εντολή, η κονσόλα παραθέτει τις ενότητες μέσα στο έγγραφο του Word.

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

curl -v -X POST "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/sections/0/headersFooters/1/paragraphs?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Text': 'Aspose.Words Cloud .NET SDK' }" \
-H "Content-Type: application/json"
λεζάντα

Console output after Text is inserted in the Header object. Observe the path of the text inserted.

Ενημέρωση της μορφοποίησης κειμένου του αντικειμένου κεφαλίδας

Μόλις εισαχθεί το κείμενο, μπορούμε να ενημερώσουμε τις ιδιότητες γραμματοσειράς κειμένου. Δεδομένου ότι ένα έγγραφο του Word μπορεί να περιέχει πολλές παρουσίες κειμένου, επομένως για να ενημερώσουμε το κείμενο, πρέπει να παρέχουμε την ακριβή διαδρομή. Επομένως, εάν πρέπει να ενημερώσουμε τις ιδιότητες γραμματοσειράς για το κείμενο που εισήχθη παραπάνω, το οποίο εισάγεται στις ενότητες/0/headersfooters/1/paragraphs/0/runs/0, τότε πρέπει να χρησιμοποιήσουμε την ακόλουθη εντολή.

Λάβετε υπόψη ότι τώρα που πρόκειται να ενημερώσουμε τις ιδιότητες γραμματοσειράς ενός ήδη τοποθετημένου αντικειμένου, πρέπει να χρησιμοποιήσουμε την εντολή PUT.

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/sections/0/headersFooters/1/paragraphs/0/runs/0/font?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Bold':true, 'Size': 21.0, 'Name': 'Calibri',  'Color': { 'Web': '#f54269', 'Alpha': 0 } }" \
-H "Content-Type: application/json"

Εισαγάγετε τον αριθμό σελίδας στο υποσέλιδο

Μία από τις σημαντικές χρήσεις των αντικειμένων Header και Footer είναι η εμφάνιση πληροφοριών αριθμού σελίδας και ενώ χρησιμοποιούμε το Aspose.Words Cloud, μπορούμε εύκολα να επιτύχουμε αυτήν την απαίτηση. Το API παρέχει επίσης τις δυνατότητες να καθορίσετε τη θέση όπου πρέπει να εμφανίζεται η σφραγίδα Αριθμός Σελίδας. Όπως φαίνεται στην παρακάτω εντολή, έχουμε ορίσει να προσθέτουμε πληροφορίες Αριθμού Σελίδας που θα αποδίδονται στην επάνω δεξιά θέση της σελίδας και επίσης να τις εμφανίζονται στην πρώτη σελίδα του εγγράφου.

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/PageNumbers?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Format': '{PAGE} of {NUMPAGES}', 'Alignment': 'right', 'IsTop': false, 'SetPageNumberOnFirstPage': true }" \
-H "Content-Type: application/json"

Παρόμοια με την ενημέρωση των ιδιοτήτων γραμματοσειράς στην παρουσία του Header, μπορούμε επίσης να ενημερώσουμε τις ιδιότητες γραμματοσειράς του αντικειμένου υποσέλιδου που περιέχει πληροφορίες Αριθμός σελίδας. Καθώς οι πληροφορίες του αριθμού σελίδας αποτελούνται από αντικείμενα τριών εκτελέσεων (runs/0, runs/2 και runs/3), έτσι πρέπει να ενημερώσουμε την εντολή ενημέρωσης γραμματοσειράς τρεις φορές για κάθε περίπτωση εκτέλεσης.

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/sections/0/headersFooters/3/paragraphs/1/runs/3/font?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Bold':true, 'Size': 21.0, 'Name': 'Arial', 'Shadow': true, 'Color': { 'Web': '#f5b642', 'Alpha': 0 } }" \
-H "Content-Type: application/json"

Μόλις εκτελεστούν όλες οι παραπάνω εντολές, το έγγραφο που προκύπτει θα μοιάζει με την παραπάνω προεπισκόπηση.

Για αναφορά σας, επισυνάπτονται και τα δείγματα εγγράφων: