Les commandes cURL sont un excellent moyen de transférer des données avec des URL. Il est recommandé d’utiliser les commandes cURL pour utiliser les API à partir de terminaux de ligne de commande. Cela nous permet non seulement de faire des requêtes régulières, mais nous pouvons également publier des données de formulaires, authentifier des utilisateurs, enregistrer des réponses à des fichiers et d’autres opérations de manipulation de fichiers associées. En termes simples, curl est un utilitaire de ligne de commande permettant de transférer des données depuis ou vers un serveur conçu pour fonctionner sans interaction de l’utilisateur. Avec curl, vous pouvez télécharger ou charger des données à l’aide de l’un des protocoles pris en charge, notamment HTTP, HTTPS, SCP, SFTP et FTP.

Néanmoins, cela nous permet également de tester les API RESTfull.

Commandes cURL utilisées

OBTENIR

La requête/opération la plus simple et la plus courante effectuée via HTTP consiste à obtenir une URL. Lorsque nous utilisons cette commande, nous envoyons une requête et récupérons des ressources à partir d’une URL spécifique (un document dans notre cas).

POSTE

La requête par défaut est un GET, mais si nous avons besoin d’utiliser la même commande cURL pour soumettre des données de formulaires, nous devons utiliser la requête POST. Par conséquent, dans cet article, nous utiliserons la même commande POST pour soumettre du contenu texte. Veuillez noter que pour publier des données, nous utilisons le paramètre -d (ou – data) avec la commande cURL.

METTRE

Il peut arriver que nous soyons confrontés à une exigence de mise à jour de données existantes, c’est pourquoi nous utilisons pour cela une méthode PUT. Pour répondre à cette exigence, nous devons utiliser -X PUT dans la commande cURL où X doit être en majuscule.

Pour plus d’informations, veuillez consulter le tutoriel cURL.

Remarque : lorsque vous utilisez des commandes cURL, assurez-vous de ne pas mettre d’espace supplémentaire après la barre oblique inverse , sinon la commande ne sera pas exécutée et des erreurs s’afficheront.

Configurer cURL sur Mac

Dans cet article, nous allons utiliser les commandes cURL sur macOS pour insérer et mettre à jour des objets Header Footer dans un document MS Word à l’aide d’une application de terminal. Donc, pour commencer, la première chose à faire est d’installer cURL sur macOS. Ouvrez l’application Terminal sous la catégorie Autres à partir du tableau de bord ou appuyez sur Commande+Espace et tapez Terminal et appuyez sur la touche Entrée/Retour. Le moyen le plus simple d’installer cURL est d’utiliser Homebrew et pour cette raison, vous devez d’abord configurer homebrew sur votre machine Mac. Tapez la commande suivante sur le terminal de ligne de commande et appuyez sur la touche Entrée.

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

Récupérez maintenant le package brew pour cURL en utilisant la commande suivante.

 brew install curl

C’est fait ! Vous pouvez maintenant utiliser curl.

Autoriser le compte Aspose.Cloud

Pour commencer à utiliser les API Aspose.Cloud, la première étape consiste à authentifier votre compte et à obtenir un JWT en réponse. Si vous n’avez pas de compte, vous pouvez en créer un sur le tableau de bord Aspose.Cloud ou vous inscrire via votre compte Google ou GitHub existant et commencer à utiliser nos 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.Cloud de mots

Aspose propose des API pour manipuler des documents MS Word et vous avez la possibilité d’utiliser des API Cloud, des API sur site ou des applications multiplateformes pour traiter des documents Word. Dans ce blog, nous avons mis l’accent sur les API Cloud qui nous offrent les capacités de créer, de manipuler et de transformer des documents MS Word dans le Cloud. Aucun téléchargement ou installation de logiciel spécifique n’est requis pour travailler avec des fichiers MS Word.

La famille de produits Aspose.Cloud fournit un ensemble de SDK cloud ciblant les langages de programmation les plus courants, notamment .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift et Go. Tous ces SDK sont un wrapper autour de Aspose.Words Cloud REST API et les commandes cURL sont l’un des moyens les plus simples et les plus faciles d’accéder aux API REST via l’invite de commande/le terminal.

Dans ce blog, nous mettons l’accent sur l’utilisation des commandes cURL pour manipuler la section En-tête et pied de page dans les fichiers MS Word lors de l’accès à Aspose.Words Cloud API.

Télécharger le document Word

Une fois l’authentification effectuée, l’étape suivante consiste à télécharger le fichier vers le stockage cloud. En utilisant la commande cURL suivante, le fichier est téléchargé vers le stockage par défaut sous 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
Sortie de la console lorsque le fichier est téléchargé sur Cloud Storage

Message de réussite lorsqu’un fichier est téléchargé vers le stockage cloud.

Maintenant, afin de confirmer la présence du fichier sur le stockage cloud, ouvrez l’onglet Mes fichiers sur dashboard.aspose.cloud, nous pouvons remarquer qu’un nouveau dossier nommé InputFolder contenant BusinessLetter2.docx apparaît dans la liste.

Dossier et fichier nouvellement créés téléchargés sur Cloud Storage

Insérer un objet d’en-tête

Après avoir téléchargé le document, nous pouvons soit insérer un nouvel objet Header ou Footer, soit accéder à un objet existant et mettre à jour ses propriétés. Actuellement, l’API Aspose.Words Cloud prend en charge les types d’objets Header et Footer suivants.

La commande suivante montre comment insérer l’objet HeaderFirst dans un document Word déjà disponible dans le stockage Cloud sous 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"

Une fois la commande ci-dessus exécutée, la console répertorie les sections à l’intérieur du document Word.

Les sections d’en-tête et de pied de page contiennent généralement du texte, des images, etc. et dans la commande suivante, nous allons insérer un exemple de texte dans le premier paragraphe à l’intérieur de l’objet d’en-tête créé ci-dessus.

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"
légende

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

Mettre à jour la mise en forme du texte de l’objet d’en-tête

Une fois le texte inséré, nous pouvons mettre à jour les propriétés de police du texte. Étant donné qu’un document Word peut contenir de nombreuses instances de texte, pour mettre à jour le texte, nous devons fournir le chemin exact. Ainsi, si nous devons mettre à jour les propriétés de police du texte inséré ci-dessus qui est inséré sur sections/0/headersfooters/1/paragraphs/0/runs/0, nous devons utiliser la commande suivante.

Veuillez noter que maintenant que nous allons mettre à jour les propriétés de police d’objets déjà placés, nous devons donc utiliser la commande 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"

Insérer le numéro de page dans le pied de page

L’une des utilisations importantes des objets Header et Footer est d’afficher les informations sur le numéro de page et, en utilisant Aspose.Words Cloud, nous pouvons facilement répondre à cette exigence. L’API fournit également les fonctionnalités permettant de spécifier l’emplacement où le tampon PageNumber doit être affiché. Comme indiqué dans la commande ci-dessous, nous avons spécifié d’ajouter les informations PageNumber à afficher dans l’emplacement supérieur droit de la page et de les afficher également sur la première page du document.

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"

De la même manière que pour la mise à jour des propriétés de police de l’instance Header, nous pouvons également mettre à jour les propriétés de police de l’objet Footer qui contient les informations PageNumber. Comme les informations sur le numéro de page sont composées d’objets à trois exécutions (runs/0, runs/2 et runs/3), nous devons mettre à jour la commande de mise à jour de police trois fois pour chaque instance d’exécution.

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"

Une fois toutes les commandes ci-dessus exécutées, le document résultant ressemblera à l’aperçu ci-dessus.

Pour votre information, les exemples de documents sont également joints :