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,包括 .NETJavaPHPPythonNode.jsAndroidC++Node.jsAndroidC++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
檔案上傳到 Cloud Storage 時的控制台輸出

文件上傳到雲端儲存時的成功訊息。

現在,為了確認檔案存在於雲端儲存中,開啟 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"
標題

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

更新 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"

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

為方便您參考,還附上了範例文件: