cURL-Befehle sind eine hervorragende Möglichkeit, Daten mit URLs zu übertragen. cURL-Befehle werden empfohlen, um APIs von Befehlszeilenterminals zu verwenden. Damit können wir nicht nur normale Anfragen stellen, sondern auch Formulardaten veröffentlichen, Benutzer authentifizieren, Antworten in Dateien speichern und andere damit verbundene Dateibearbeitungsvorgänge durchführen. Einfach ausgedrückt ist curl ein Befehlszeilenprogramm zum Übertragen von Daten von oder zu einem Server, das ohne Benutzerinteraktion funktioniert. Mit curl können Sie Daten mithilfe eines der unterstützten Protokolle herunterladen oder hochladen, darunter HTTP, HTTPS, SCP, SFTP und FTP.

Dennoch erleichtert es uns auch, RESTfull-APIs zu testen.

Verwendete cURL-Befehle

ERHALTEN

Die einfachste und häufigste Anfrage/Operation, die mit HTTP durchgeführt wird, ist das Abrufen einer URL. Mit diesem Befehl senden wir eine Anfrage und rufen Ressourcen von einer bestimmten URL ab (in unserem Fall ein Dokument).

POST

Die Standardanforderung ist ein GET, aber wenn wir denselben cURL-Befehl zum Senden von Formulardaten verwenden müssen, müssen wir eine POST-Anforderung verwenden. Daher verwenden wir in diesem Artikel denselben POST-Befehl zum Senden von Textinhalten. Bitte beachten Sie, dass wir zum Senden von Daten den Parameter -d (oder – data) mit dem cURL-Befehl verwenden.

SETZEN

Möglicherweise müssen wir vorhandene Daten aktualisieren. Zu diesem Zweck wird eine PUT-Methode verwendet. Um diese Anforderung zu erfüllen, müssen wir im cURL-Befehl -X PUT verwenden, wobei X groß geschrieben werden muss.

Weitere Informationen finden Sie im cURL-Tutorial.

Hinweis: Achten Sie bei der Verwendung von cURL-Befehlen darauf, dass Sie nach dem Backslash \ kein zusätzliches Leerzeichen einfügen. Andernfalls wird der Befehl nicht ausgeführt und es werden Fehler angezeigt.

Einrichten von cURL auf dem Mac

In diesem Artikel verwenden wir cURL-Befehle auf macOS, um Header und Footer Objekte in MS Word Dokumente mithilfe einer Terminalanwendung einzufügen und zu aktualisieren. Um loszulegen, müssen Sie zunächst cURL auf macOS installieren. Öffnen Sie die Terminalanwendung unter der Kategorie „Sonstiges“ im Launchpad oder drücken Sie Befehl+Leertaste, geben Sie „Terminal“ ein und drücken Sie die Eingabetaste. Die einfachste Möglichkeit, cURL zu installieren, ist die Verwendung von Homebrew. Aus diesem Grund müssen Sie zunächst Homebrew auf Ihrem Mac-Computer einrichten. Geben Sie den folgenden Befehl in das Befehlszeilenterminal ein und drücken Sie die Eingabetaste.

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

Holen Sie sich jetzt mit dem folgenden Befehl das Brew-Paket für cURL.

 brew install curl

Fertig! Sie können jetzt curl verwenden.

Aspose.Cloud-Konto autorisieren

Um mit Aspose.Cloud APIs loszulegen, müssen Sie zunächst Ihr Konto authentifizieren und als Antwort JWT erhalten. Wenn Sie kein Konto haben, können Sie eines im Aspose.Cloud-Dashboard erstellen oder sich über Ihr bestehendes Google oder GitHub-Konto anmelden und mit der Nutzung unserer Cloud-APIs beginnen.

// 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 bietet APIs zur Bearbeitung von MS Word Dokumenten und Sie haben die Möglichkeit, entweder Cloud-APIs, On-Premise-APIs oder plattformübergreifende Apps zur Bearbeitung von Word Dokumenten zu verwenden. In diesem Blog haben wir Cloud-APIs hervorgehoben, die uns die Möglichkeit bieten, MS Word Dokumente in der Cloud zu erstellen, zu bearbeiten und zu transformieren. Für die Arbeit mit MS Word Dateien ist kein spezieller Software-Download oder keine spezielle Software-Installation erforderlich.

Die Aspose.Cloud-Produktfamilie bietet eine Reihe von Cloud-SDKs für gängige Programmiersprachen, darunter .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift und Go. Alle diese SDKs sind ein Wrapper um Aspose.Words Cloud REST API und cURL-Befehle sind eine der einfachsten und leichtesten Möglichkeiten, über die Eingabeaufforderung/das Terminal auf REST-APIs zuzugreifen.

In diesem Blog betonen wir die Verwendung von cURL-Befehlen zur Bearbeitung des Kopf und Fußzeilenbereichs in MS Word Dateien beim Zugriff auf Aspose.Words Cloud API.

Word Dokument hochladen

Sobald die Authentifizierung durchgeführt wurde, besteht der nächste Schritt darin, die Datei in den Cloud-Speicher hochzuladen. Mit dem folgenden cURL-Befehl wird die Datei in den Standardspeicher unter InputFolder hochgeladen.

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
Konsolenausgabe, wenn eine Datei in den Cloud-Speicher hochgeladen wird

Erfolgsmeldung, wenn eine Datei in den Cloud-Speicher hochgeladen wurde.

Um nun die Anwesenheit der Datei im Cloud-Speicher zu bestätigen, öffnen Sie die Registerkarte „Meine Dateien“ über dashboard.aspose.cloud. Wir sehen, dass in der Liste ein neuer Ordner mit dem Namen InputFolder erscheint, der BusinessLetter2.docx enthält.

Neu erstellter Ordner und Datei auf Cloud Storage hochgeladen

Header Objekt einfügen

Nach dem Hochladen des Dokuments können wir entweder ein neues Header oder Footer Objekt einfügen oder auf ein vorhandenes Objekt zugreifen und dessen Eigenschaften aktualisieren. Derzeit unterstützt die Aspose.Words Cloud API die folgenden Arten von Header und Footer Objekten.

Der folgende Befehl zeigt, wie ein HeaderFirst Objekt in ein Word Dokument eingefügt wird, das bereits im Cloud-Speicher unter InputFolder verfügbar ist.

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"

Sobald der obige Befehl ausgeführt wurde, listet die Konsole die Abschnitte im Word Dokument auf.

Die Kopf und Fußzeilenabschnitte enthalten normalerweise Text, Bilder usw. und im folgenden Befehl fügen wir einen Beispieltext in den ersten Absatz des oben erstellten Kopfzeilenobjekts ein.

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"
Bildunterschrift

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

Textformatierung des Header Objekts aktualisieren

Sobald der Text eingefügt ist, können wir die Schrifteigenschaften des Textes aktualisieren. Da ein Word Dokument viele Textinstanzen enthalten kann, müssen wir den genauen Pfad angeben, um den Text zu aktualisieren. Wenn wir also die Schrifteigenschaften für den oben eingefügten Text aktualisieren müssen, der über Abschnitte/0/Kopfzeilen/Fußzeilen/1/Absätze/0/Läufe/0 eingefügt wird, müssen wir den folgenden Befehl verwenden.

Bitte beachten Sie, dass wir jetzt die Schrifteigenschaften eines bereits platzierten Objekts aktualisieren und daher den Befehl PUT verwenden müssen.

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"

Seitenzahl in Fußzeile einfügen

Eine der wichtigsten Verwendungen von Header und Footer Objekten ist die Anzeige von Seitenzahleninformationen. Mit Aspose.Words Cloud können wir diese Anforderung problemlos erfüllen. Die API bietet auch die Möglichkeit, den Ort anzugeben, an dem der Seitenzahlenstempel angezeigt werden soll. Wie im folgenden Befehl gezeigt, haben wir angegeben, dass Seitenzahleninformationen oben rechts auf der Seite angezeigt und auch auf der ersten Seite des Dokuments angezeigt werden sollen.

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"

Ähnlich wie bei der Aktualisierung der Schrifteigenschaften für die Header-Instanz können wir auch die Schrifteigenschaften des Footer Objekts aktualisieren, das Seitennummerninformationen enthält. Da die Seitennummerninformationen aus drei Run Objekten bestehen (Runs/0, Runs/2 und Runs/3), müssen wir den Befehl zur Schriftaktualisierung dreimal für jede Run-Instanz aktualisieren.

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"

Sobald alle oben genannten Befehle ausgeführt wurden, sieht das resultierende Dokument ähnlich wie die Vorschau oben aus.

Zu Ihrer Information sind die Beispieldokumente auch beigefügt: