在 macOS 上使用 cURL 指令處理 MS Word 文件的頁首和頁尾

cURL 指令是使用 URL 傳輸資料的絕佳方式。建議使用 cURL 命令來從命令列終端使用 API。它不僅允許我們發出常規請求，還可以發布表單資料、驗證使用者、保存對文件的回應以及其他相關的文件操作。簡而言之，curl 是一個命令列實用程序，用於從伺服器傳輸數據或向伺服器傳輸數據，無需用戶互動即可運行。使用 curl，您可以使用受支援的協定之一(包括 HTTP、HTTPS、SCP、SFTP 和 FTP)下載或上傳資料。

儘管如此，它也方便我們測試 RESTfull API。

使用的 cURL 指令

得到

使用 HTTP 發出的最簡單、最常見的請求/操作是取得 URL。使用此命令時，我們發送請求並從特定 URL(在我們的例子中是文件)檢索資源。

郵政

預設請求是 GET，但如果我們需要使用相同的 cURL 命令提交表單數據，則需要使用 POST 請求。因此在本文中，我們將使用相同的 POST 指令來提交文字內容。請注意，為了發布數據，我們在 cURL 命令中使用 -d(或 –data)參數。

放

我們可能會偶然發現更新現有資料的需求，因此為了這個目的，使用了 PUT 方法。為了滿足這項要求，我們需要在 cURL 指令中使用 -X PUT，其中 X 需要大寫。

欲了解更多信息，請訪問cURL 教程。

注意：使用 cURL 指令時，請確保反斜線 \ 後沒有多餘的空格，否則該指令將不會被執行並且會顯示錯誤。

在 Mac 上設定 cURL

在本文中，我們將使用 macOS 上的 cURL 命令透過終端應用程式插入和更新 MS Word 文件內的頁首頁腳物件。因此，為了開始，第一件事是在 macOS 上安裝 cURL。從啟動板打開其他類別下的終端應用程序，或按 Command+Space 並輸入終端，然後按回車/返回鍵。安裝 cURL 最簡單的方法是使用 Homebrew，因此，首先，您需要在您的 Mac 機器上設定 Homebrew。在命令列終端機上輸入以下命令並按 Enter 鍵。

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

現在使用以下指令取得 cURL 的 brew 套件。

 brew install curl 
複製

完畢！您現在可以使用 curl。

授權 Aspose.Cloud 帳戶

為了開始使用 Aspose.Cloud API，第一步是驗證您的帳戶並取得 JWT 作為回應。如果您沒有帳戶，您可以在 Aspose.Cloud 儀表板 上建立一個，或透過您現有的 Google 或 GitHub 帳戶註冊並開始使用我們的雲端 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 雲

Aspose 提供 API 來操作 MS Word 文檔，您可以選擇使用 雲端 API、本地 API 或 跨平台應用程式 來處理 Word 文件。在此部落格中，我們強調了雲端 API，它為我們提供了在雲端中建立、操作和轉換 MS Word 文件的功能。無需下載或安裝特定軟體即可處理 MS Word 檔案。

Aspose.Cloud 產品系列提供了一組針對流行程式語言的雲端 SDK，包括 .NET、Java、PHP、Python、Node.js、Android、C++、Node.js、Android、C++、50、[Android][51]、C++、Ruby、[Android][51]。所有這些 SDK 都是 Aspose.Words Cloud REST API 的包裝器，而 cURL 命令是透過命令提示字元/終端存取 REST API 的最簡單、最輕鬆的方法之一。

在這篇部落格中，我們強調在存取 Aspose.Words Cloud API 時使用 cURL 指令來操作 MS Word 文件內的頁首和頁尾部分。

上傳 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
複製

現在，為了確認檔案存在於雲端儲存中，開啟 dashboard.aspose.cloud 上的「我的檔案」標籤，我們可以注意到清單中出現了一個名為 InputFolder 的新資料夾，其中包含 BusinessLetter2.docx。

插入 Header 對象

上傳文件後，我們可以插入新的 Header 或 Footer 對象，或存取現有對象並更新其屬性。目前，Aspose.Words Cloud API 支援以下類型的 Header 和 Footer 物件。

以下指令顯示如何在 InputFolder 下的雲端儲存中已有的 Word 文件中插入 HeaderFirst 物件。

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"
複製

更新 Header 物件的文字格式

插入文字後，我們可以更新文字字體屬性。由於一個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戳記的位置的功能。如下命令所示，我們指定新增 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 實例的字體屬性類似，我們也可以更新包含 PageNumber 資訊的 Footer 物件的字體屬性。由於頁碼資訊由三個運行物件(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"
複製

一旦執行了上述所有命令，生成的文件將類似於上面的預覽。

為方便您參考，還附上了範例文件：

• 輸入檔
• 結果文件