cURL-kommandoer er en fremragende måde at overføre data med URL’er. cURL-kommandoer anbefales for at bruge API’er fra kommandolinjeterminaler. Det giver os ikke kun mulighed for at lave regelmæssige anmodninger, men vi kan også sende formulardata, autentificere brugere, gemme svar på filer og andre relaterede filmanipulationsoperationer. Med enkle ord er curl et kommandolinjeværktøj til at overføre data fra eller til en server designet til at fungere uden brugerinteraktion. Med curl kan du downloade eller uploade data ved hjælp af en af de understøttede protokoller, herunder HTTP, HTTPS, SCP, SFTP og FTP.

Ikke desto mindre letter det os også at teste RESTfull API’er.

cURL-kommandoer brugt

FÅ

Den enkleste og mest almindelige anmodning/operation lavet ved hjælp af HTTP er at FÅ en URL. Når vi bruger denne kommando, sender vi en anmodning og henter ressourcer fra en bestemt URL (et dokument i vores tilfælde).

STOLPE

Standardanmodningen er en GET, men hvis vi har et krav om at bruge den samme cURL-kommando til indsendelse af formulardata, skal vi bruge POST-anmodning. Derfor vil vi i denne artikel bruge den samme POST-kommando til at indsende tekstindhold. Bemærk venligst, at for at sende data, bruger vi -d (eller – data) parameter med cURL kommandoen.

SÆTTE

Vi kan falde over et krav om at opdatere eksisterende data, så til det formål bruges en PUT-metode. For at opfylde dette krav skal vi bruge -X PUT i kommandoen cURL, hvor X skal være med store bogstaver.

For yderligere information, besøg venligst cURL tutorial.

Bemærk: Når du bruger cURL-kommandoer, skal du sikre dig, at du ikke sætter et ekstra mellemrum efter omvendt skråstreg \ else, kommandoen vil ikke blive udført, og fejl vil blive vist.

Opsætning af cURL på Mac

I denne artikel skal vi bruge cURL-kommandoer på macOS til at indsætte og opdatere sidehoved-footer-objekter i MS Word-dokument ved hjælp af et terminalprogram. Så for at komme i gang er den første ting at installere cURL på macOS. Åbn Terminal-applikationen under kategorien Andre fra startpanelet, eller tryk på Kommando+Mellemrum og skriv Terminal og tryk på enter/retur-tasten. Den nemmeste måde at installere cURL på er at bruge Homebrew, og af den grund skal du først konfigurere homebrew på din mac-maskine. Skriv følgende kommando på kommandolinjeterminalen og tryk på Enter-tasten.

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

Hent nu brygpakken til cURL ved hjælp af følgende kommando.

 brew install curl

Færdig! Du kan nu bruge curl.

Godkend Aspose.Cloud-konto

For at komme i gang med Aspose.Cloud API’er, er det første trin at autentificere din konto og få JWT som svar. Hvis du ikke har en konto, kan du oprette en på Aspose.Cloud-dashboard eller tilmelde dig via din eksisterende Google- eller GitHub-konto og begynde at bruge vores Cloud API’er.

// 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 tilbyder API’er til at manipulere MS Word-dokumenter, og du får mulighed for enten at bruge Cloud API’er, On-Premise API’er eller Cross-platform Apps til at behandle Word-dokumenter. I denne blog har vi lagt vægt på Cloud API’er, som giver os mulighederne for at skabe, manipulere og transformere MS Word-dokumenter i skyen. Der kræves ingen specifik softwaredownload eller installation for at arbejde med MS Word-filer.

Aspose.Cloud-produktfamilien leverer et sæt cloud-SDK’er rettet mod populære programmeringssprog, herunder .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift og Go. Alle disse SDK’er er en indpakning omkring Aspose.Words Cloud REST API, og cURL-kommandoer er en af de enkleste og nemmeste måder at få adgang til REST API’er via kommandoprompt/terminal.

I denne blog lægger vi vægt på at bruge cURL-kommandoer til at manipulere sidehoved- og sidefodssektionen inde i MS Word-filer, mens vi får adgang til Aspose.Words Cloud API.

Upload Word-dokument

Når godkendelsen er udført, er næste trin at uploade filen til skylageret. Ved at bruge følgende cURL-kommando uploades filen til standardlageret under 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
Konsoloutput, når filen uploades til Cloud Storage

Succesmeddelelse, når en fil uploades til skylageret.

For nu at bekræfte filtilstedeværelsen på skylageret skal du åbne fanen Mine filer over dashboard.aspose.cloud, vi kan bemærke, at en ny mappe ved navn InputFolder, der indeholder BusinessLetter2.docx, vises på listen.

Nyoprettet mappe og fil uploadet til Cloud Storage

Indsæt overskriftsobjekt

Efter upload af dokumentet kan vi enten indsætte et nyt sidehoved- eller sidefodsobjekt eller få adgang til et eksisterende objekt og opdatere dets egenskaber. I øjeblikket understøtter Aspose.Words Cloud API følgende typer header- og footer-objekter.

Følgende kommando viser, hvordan du indsætter HeaderFirst-objekt i Word-dokument, der allerede er tilgængeligt i Cloud-lagring under 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"

Når ovenstående kommando er udført, viser konsollen sektionerne i Word-dokumentet.

Sidehoved- og Footer-sektionerne indeholder normalt tekst, billeder osv., og i den følgende kommando vil vi indsætte en eksempeltekst i det første afsnit inde i header-objektet, der er oprettet ovenfor.

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

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

Opdater tekstformatering af Header-objektet

Når teksten er indsat, kan vi opdatere tekstfontegenskaberne. Da et word-dokument kan indeholde mange tekstforekomster, så for at opdatere teksten, skal vi angive den nøjagtige sti. Så hvis vi skal opdatere skrifttypeegenskaberne for den ovenstående indsatte tekst, som er indsat over sektioner/0/headersfooters/1/paragraphs/0/runs/0, så skal vi bruge følgende kommando.

Bemærk venligst, at nu hvor vi skal opdatere skrifttypeegenskaberne for et allerede placeret objekt, så vi skal bruge PUT-kommandoen.

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"

Indsæt sidenummer i sidefod

En af de vigtige anvendelser af Header- og Footer-objekter er at vise sidetalsoplysninger, og mens vi bruger Aspose.Words Cloud, kan vi nemt opfylde dette krav. API’en giver også mulighed for at angive den placering, hvor sidenummerstemplet skal vises. Som vist i kommandoen nedenfor, har vi specificeret at tilføje sidenummer-oplysninger, der skal gengives øverst til højre på siden og også vise det over den første side af dokumentet.

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"

I lighed med skrifttypeegenskabsopdatering til Header-forekomst, kan vi også opdatere skrifttypeegenskaberne for Footer-objekt, som indeholder PageNumber-oplysninger. Da sidenummeroplysningerne består af tre-run-objekter (runs/0, runs/2 og runs/3), så vi skal opdatere kommandoen font update tre gange for hver run-forekomst.

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"

Når alle de ovennævnte kommandoer er udført, vil det resulterende dokument se ud som eksemplet ovenfor.

Til din reference er prøvedokumenterne også vedhæftet: