Команди 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.

Примітка: під час використання команд cURL переконайтеся, що ви не ставите зайвий пробіл після зворотної скісної риски \ else, команда не буде виконана та відображатимуться помилки.

Налаштування cURL на Mac

У цій статті ми збираємося використовувати команди cURL у macOS, щоб вставляти та оновлювати об’єкти нижнього колонтитула всередині документа MS Word за допомогою термінальної програми. Отже, щоб розпочати, перше, що потрібно встановити cURL на macOS. Відкрийте програму «Термінал» у категорії «Інші» на панелі запуску або натисніть «Command+Пробіл», введіть «Термінал» і натисніть клавішу «Enter/Return». Найпростіший спосіб інсталювати cURL — це використовувати Homebrew, тому спершу вам потрібно налаштувати homebrew на комп’ютері Mac. Введіть наступну команду в терміналі командного рядка та натисніть клавішу Enter.

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

Тепер отримайте пакет brew для cURL за допомогою такої команди.

 brew install curl

Готово! Тепер можна використовувати curl.

Авторизуйте обліковий запис Aspose.Cloud

Щоб розпочати роботу з Aspose.Cloud APIs, першим кроком є автентифікація вашого облікового запису та отримання JWT у відповідь. Якщо у вас немає облікового запису, ви можете створити його на інформаційній панелі Aspose.Cloud або зареєструватися через наявний обліковий запис Google або GitHub і почати використовувати наші 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.Words Cloud

Aspose пропонує API для роботи з документами MS Word, і ви можете використовувати Cloud APIs, On-Premise APIs або Кросплатформені програми для обробки документів Word. У цьому блозі ми акцентували увагу на хмарних API, які надають нам можливості створювати, маніпулювати та трансформувати документи MS Word у хмарі. Для роботи з файлами MS Word не потрібно завантажувати або інсталювати спеціальне програмне забезпечення.

Сімейство продуктів Aspose.Cloud надає набір хмарних SDK для популярних мов програмування, зокрема .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift і Go. Усі ці SDK є оболонкою Aspose.Words Cloud REST API, а команди cURL є одним із найпростіших і найлегших способів доступу до REST API через командний рядок/термінал.

У цьому блозі ми наголошуємо на використанні команд cURL для маніпулювання розділами верхнього та нижнього колонтитулів у файлах MS Word під час доступу до Aspose.Words Cloud API.

Завантажте документ Word

Після автентифікації наступним кроком є завантаження файлу в хмарне сховище. За допомогою наведеної нижче команди 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

Повідомлення про успішне завантаження файлу в хмарне сховище.

Тепер, щоб підтвердити присутність файлу в хмарному сховищі, відкрийте вкладку «Мої файли» над dashboard.aspose.cloud, ми можемо помітити, що в списку з’являється нова папка з назвою InputFolder, що містить BusinessLetter2.docx.

Щойно створена папка та файл, завантажені в Cloud Storage

Вставити об’єкт «Заголовок».

Після завантаження документа ми можемо вставити новий об’єкт «Верхній або нижній колонтитул» або отримати доступ до існуючого об’єкта та оновити його властивості. Наразі Aspose.Words Cloud API підтримує такі типи об’єктів верхнього та нижнього колонтитулів.

Наступна команда показує, як вставити об’єкт HeaderFirst у документ Word, який уже доступний у хмарному сховищі у 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"
Виведення на консоль після вставки тексту в об’єкт «Заголовок». Зверніть увагу на шлях вставленого тексту.

Виведення на консоль після вставки тексту в об’єкт «Заголовок». Зверніть увагу на шлях вставленого тексту.

Оновити форматування тексту об’єкта «Заголовок».

Після вставлення тексту ми можемо оновити властивості шрифту тексту. Оскільки документ Word може містити багато екземплярів тексту, тому, щоб оновити текст, нам потрібно надати точний шлях. Отже, якщо нам потрібно оновити властивості шрифту для вставленого вище тексту, який вставляється поверх sections/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 також надає можливості вказати місце, де потрібно відобразити штамп PageNumber. Як показано в команді нижче, ми вказали, що потрібно додати інформацію про номер сторінки, яка буде відображена у верхньому правому куті сторінки, а також відобразити її на першій сторінці документа.

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, ми також можемо оновити властивості шрифту об’єкта Footer, який містить інформацію PageNumber. Оскільки інформація про номер сторінки складається з трьох об’єктів запуску (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"

Після виконання всіх наведених вище команд результуючий документ виглядатиме подібно до попереднього перегляду вище.

Для ознайомлення зразки документів також додаються: