I comandi cURL sono un modo eccellente per trasferire dati con URL. Si consiglia di usare i comandi cURL tramite API da terminali a riga di comando. Non solo ci consente di effettuare richieste regolari, ma possiamo anche inviare dati di moduli, autenticare utenti, salvare risposte a file e altre operazioni di manipolazione di file correlate. In parole semplici, curl è un’utilità a riga di comando per trasferire dati da o verso un server progettato per funzionare senza interazione dell’utente. Con curl, puoi scaricare o caricare dati utilizzando uno dei protocolli supportati, tra cui HTTP, HTTPS, SCP, SFTP e FTP.
Tuttavia, ci facilita anche il test delle API RESTfull.
Comandi cURL utilizzati
OTTENERE
La richiesta/operazione più semplice e comune effettuata tramite HTTP è GET un URL. Quando si utilizza questo comando, inviamo una richiesta e recuperiamo risorse da un URL specifico (un documento nel nostro caso).
INVIARE
La richiesta predefinita è GET, ma se abbiamo la necessità di usare lo stesso comando cURL per inviare i dati dei moduli, dobbiamo usare la richiesta POST. Pertanto, in questo articolo, useremo lo stesso comando POST per inviare il contenuto di testo. Si noti che per inviare i dati, utilizziamo il parametro -d (o – data) con il comando cURL.
METTERE
Potremmo imbatterci in un requisito di aggiornamento dei dati esistenti, quindi a tale scopo, viene utilizzato un metodo PUT. Per soddisfare questo requisito, dobbiamo utilizzare -X PUT nel comando cURL, dove X deve essere in maiuscolo.
Per ulteriori informazioni, visitare tutorial cURL.
Nota: quando si utilizzano i comandi cURL, assicurarsi di non inserire uno spazio extra dopo la barra rovesciata , altrimenti il comando non verrà eseguito e verranno visualizzati degli errori.
Impostazione di cURL su Mac
In questo articolo, utilizzeremo i comandi cURL su macOS per inserire e aggiornare gli oggetti Header Footer all’interno del documento MS Word utilizzando un’applicazione terminale. Quindi, per iniziare, la prima cosa da fare è installare cURL su macOS. Apri l’applicazione Terminale nella categoria Altri dal launchpad oppure premi Comando+Spazio e digita Terminale e premi il tasto Invio/Invio. Il modo più semplice per installare cURL è usare Homebrew e per questo motivo, prima di tutto, devi configurare Homebrew sul tuo computer Mac. Digita il seguente comando sul terminale della riga di comando e premi il tasto Invio.
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null
Ora ottieni il pacchetto brew per cURL utilizzando il seguente comando.
brew install curl
Fatto! Ora puoi usare curl.
Autorizza l’account Aspose.Cloud
Per iniziare a usare Aspose.Cloud APIs, il primo passo è autenticare il tuo account e ottenere JWT in risposta. Se non hai un account, puoi crearne uno su Aspose.Cloud dashboard o registrarti tramite il tuo account Google o GitHub esistente e iniziare a usare le nostre Cloud API.
// 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.Cloud di parole
Aspose offre API per manipolare documenti MS Word e hai la possibilità di usare API Cloud, API On-Premise o App multipiattaforma per elaborare documenti Word. In questo blog, abbiamo sottolineato le API Cloud che ci forniscono le capacità di creare, manipolare e trasformare documenti MS Word nel Cloud. Non è richiesto alcun download o installazione di software specifico per lavorare con file MS Word.
La famiglia di prodotti Aspose.Cloud fornisce un set di SDK cloud destinati ai linguaggi di programmazione più diffusi, tra cui .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift e Go. Tutti questi SDK sono un wrapper per Aspose.Words Cloud REST API e i comandi cURL sono uno dei modi più semplici e facili per accedere alle API REST tramite prompt dei comandi/terminale.
In questo blog, focalizziamo l’attenzione sull’utilizzo dei comandi cURL per manipolare la sezione Intestazione e Piè di pagina all’interno dei file MS Word durante l’accesso a Aspose.Words Cloud API.
Carica documento Word
Una volta eseguita l’autenticazione, il passo successivo è caricare il file sullo storage cloud. Utilizzando il seguente comando cURL, il file viene caricato sullo storage predefinito in 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
Messaggio di successo quando un file viene caricato sullo storage cloud.
Ora, per confermare la presenza del file nell’archiviazione cloud, apriamo la scheda I miei file su dashboard.aspose.cloud, possiamo notare che una nuova cartella denominata InputFolder contenente BusinessLetter2.docx appare nell’elenco.
Inserisci oggetto Intestazione
Dopo aver caricato il documento, possiamo inserire un nuovo oggetto Header o Footer oppure accedere a un oggetto esistente e aggiornarne le proprietà. Attualmente, Aspose.Words Cloud API supporta i seguenti tipi di oggetti Header e Footer.
Il seguente comando mostra come inserire l’oggetto HeaderFirst all’interno di un documento Word già disponibile nell’archivio Cloud in 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"
Una volta eseguito il comando sopra, la console elenca le sezioni all’interno del documento Word.
Le sezioni Intestazione e Piè di pagina solitamente contengono testo, immagini, ecc. e nel comando seguente inseriremo un testo di esempio all’interno del primo paragrafo all’interno dell’oggetto Intestazione creato sopra.
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"
Aggiorna la formattazione del testo dell’oggetto Intestazione
Una volta inserito il testo, possiamo aggiornare le proprietà del font del testo. Poiché un documento Word può contenere molte istanze di testo, per aggiornare il testo dobbiamo fornire il percorso esatto. Quindi, se dobbiamo aggiornare le proprietà del font per il testo inserito sopra, che è inserito su sezioni/0/intestazioni/piè di pagina/1/paragrafi/0/esegui/0, dobbiamo usare il seguente comando.
Si noti che ora aggiorneremo le proprietà del font di un oggetto già posizionato, per cui dovremo usare il comando 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"
Inserisci il numero di pagina nel piè di pagina
Uno degli utilizzi importanti degli oggetti Header e Footer è visualizzare le informazioni sul numero di pagina e, utilizzando Aspose.Words Cloud, possiamo facilmente soddisfare questo requisito. L’API fornisce anche le capacità per specificare la posizione in cui deve essere visualizzato il timbro PageNumber. Come mostrato nel comando seguente, abbiamo specificato di aggiungere le informazioni PageNumber da visualizzare nella posizione in alto a destra della pagina e di visualizzarle anche sulla prima pagina del documento.
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"
Similmente all’aggiornamento delle proprietà del font all’istanza Header, possiamo anche aggiornare le proprietà del font dell’oggetto Footer che contiene le informazioni PageNumber. Poiché le informazioni sul numero di pagina sono composte da oggetti a tre run (runs/0, runs/2 e runs/3), dobbiamo aggiornare il comando di aggiornamento del font tre volte per ogni istanza di run.
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"
Una volta eseguiti tutti i comandi sopra indicati, il documento risultante sarà simile all’anteprima qui sopra.
Per vostra informazione, sono allegati anche i seguenti documenti campione: