Lệnh cURL là một cách tuyệt vời để truyền dữ liệu bằng URL. Lệnh cURL được khuyến nghị sử dụng API từ các thiết bị đầu cuối dòng lệnh. Nó không chỉ cho phép chúng ta thực hiện các yêu cầu thường xuyên mà còn có thể đăng dữ liệu biểu mẫu, xác thực người dùng, lưu phản hồi vào tệp và các hoạt động thao tác tệp liên quan khác. Nói một cách đơn giản, curl là một tiện ích dòng lệnh để truyền dữ liệu từ hoặc đến máy chủ được thiết kế để hoạt động mà không cần tương tác của người dùng. Với curl, bạn có thể tải xuống hoặc tải lên dữ liệu bằng một trong các giao thức được hỗ trợ bao gồm HTTP, HTTPS, SCP, SFTP và FTP.

Tuy nhiên, nó cũng giúp chúng ta kiểm tra API RESTfull dễ dàng hơn.

lệnh cURL được sử dụng

LẤY

Yêu cầu/hoạt động đơn giản và phổ biến nhất được thực hiện bằng HTTP là GET một URL. Khi sử dụng lệnh này, chúng ta gửi yêu cầu và lấy tài nguyên từ một URL cụ thể (trong trường hợp của chúng ta là một tài liệu).

BƯU KIỆN

Yêu cầu mặc định là GET nhưng nếu chúng ta có yêu cầu sử dụng cùng lệnh cURL để gửi dữ liệu biểu mẫu, chúng ta cần sử dụng yêu cầu POST. Do đó, trong bài viết này, chúng ta sẽ sử dụng cùng lệnh POST để gửi nội dung văn bản. Xin lưu ý rằng để đăng dữ liệu, chúng ta sử dụng tham số -d (hoặc – data) với lệnh cURL.

ĐẶT

Chúng ta có thể gặp phải yêu cầu cập nhật dữ liệu hiện có, vì vậy, phương pháp PUT được sử dụng cho mục đích đó. Để thực hiện yêu cầu này, chúng ta cần sử dụng -X PUT trong lệnh cURL trong đó X cần phải viết hoa.

Để biết thêm thông tin, vui lòng truy cập hướng dẫn cURL.

Lưu ý: khi sử dụng lệnh cURL, hãy đảm bảo bạn không đặt thêm khoảng trắng sau dấu gạch chéo ngược \ nếu không, lệnh sẽ không được thực thi và lỗi sẽ hiển thị.

Thiết lập cURL trên máy Mac

Trong bài viết này, chúng ta sẽ sử dụng lệnh cURL trên macOS để chèn và cập nhật các đối tượng Header Footer bên trong tài liệu MS Word bằng ứng dụng terminal. Vì vậy, để bắt đầu, điều đầu tiên là cài đặt cURL trên macOS. Mở ứng dụng Terminal trong danh mục Others từ launchpad hoặc, Nhấn Command+Space và nhập Terminal rồi nhấn phím enter/return. Cách dễ nhất để cài đặt cURL là sử dụng Homebrew và vì lý do đó, trước tiên, bạn cần thiết lập homebrew trên máy Mac của mình. Nhập lệnh sau trên terminal dòng lệnh và nhấn phím Enter.

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

Bây giờ hãy lấy gói brew cho cURL bằng lệnh sau.

 brew install curl

Xong! Bây giờ bạn có thể sử dụng curl.

Ủy quyền tài khoản Aspose.Cloud

Để bắt đầu với Aspose.Cloud APIs, bước đầu tiên là xác thực tài khoản của bạn và nhận JWT phản hồi. Nếu bạn không có tài khoản, bạn có thể tạo một tài khoản trên Aspose.Cloud dashboard hoặc đăng ký thông qua tài khoản Google hoặc GitHub hiện có của bạn và bắt đầu sử dụng Cloud APIs của chúng tôi.

// 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 cung cấp API để thao tác với các tài liệu MS Word và bạn có tùy chọn sử dụng Cloud API, On-Premise API hoặc Cross-platform Apps để xử lý các tài liệu Word. Trong blog này, chúng tôi đã nhấn mạnh hơn về Cloud API cung cấp cho chúng tôi khả năng tạo, thao tác và chuyển đổi các tài liệu MS Word trên Cloud. Không cần tải xuống hoặc cài đặt phần mềm cụ thể nào để làm việc với các tệp MS Word.

Gia đình sản phẩm Aspose.Cloud cung cấp một bộ SDK đám mây nhắm mục tiêu đến các ngôn ngữ lập trình phổ biến bao gồm .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift và Go. Tất cả các SDK này là một trình bao bọc xung quanh Aspose.Words Cloud REST API và lệnh cURL là một trong những cách đơn giản và dễ dàng nhất để truy cập REST API qua dấu nhắc lệnh/thiết bị đầu cuối.

Trong blog này, chúng tôi tập trung vào việc sử dụng lệnh cURL để thao tác phần Đầu trang và Chân trang bên trong các tệp MS Word khi truy cập Aspose.Words Cloud API.

Tải lên tài liệu Word

Sau khi xác thực được thực hiện, bước tiếp theo là tải tệp lên bộ nhớ đám mây. Bằng cách sử dụng lệnh cURL sau, tệp được tải lên bộ nhớ mặc định trong 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
Đầu ra của bảng điều khiển khi tệp được tải lên Cloud Storage

Thông báo thành công khi tệp được tải lên bộ nhớ đám mây.

Bây giờ để xác nhận sự hiện diện của tệp trên bộ nhớ đám mây, hãy mở tab Tệp của tôi trên dashboard.aspose.cloud, chúng ta có thể thấy một thư mục mới có tên InputFolder chứa BusinessLetter2.docx xuất hiện trong danh sách.

Thư mục và tệp mới được tạo đã tải lên Cloud Storage

Chèn đối tượng Header

Sau khi tải tài liệu lên, chúng ta có thể chèn đối tượng Header hoặc Footer mới hoặc truy cập đối tượng hiện có và cập nhật thuộc tính của đối tượng đó. Hiện tại, Aspose.Words Cloud API hỗ trợ các loại đối tượng Header và Footer sau.

Lệnh sau đây cho biết cách chèn đối tượng HeaderFirst vào bên trong tài liệu Word đã có sẵn trong bộ nhớ đám mây tại 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"

Sau khi lệnh trên được thực thi, bảng điều khiển sẽ liệt kê các phần bên trong tài liệu Word.

Phần Header và Footer thường chứa văn bản, hình ảnh, v.v. và trong lệnh sau, chúng ta sẽ chèn một văn bản mẫu vào đoạn văn đầu tiên bên trong đối tượng header đã tạo ở trên.

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"
chú thích

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

Cập nhật định dạng văn bản của đối tượng Header

Sau khi chèn văn bản, chúng ta có thể cập nhật thuộc tính phông chữ văn bản. Vì một tài liệu Word có thể chứa nhiều trường hợp văn bản, do đó để cập nhật văn bản, chúng ta cần cung cấp đường dẫn chính xác. Vì vậy, nếu chúng ta cần cập nhật thuộc tính phông chữ cho văn bản được chèn ở trên được chèn qua các phần/0/headersfooters/1/paragraphs/0/runs/0, thì chúng ta cần sử dụng lệnh sau.

Xin lưu ý rằng bây giờ chúng ta sẽ cập nhật thuộc tính phông chữ của các đối tượng đã được đặt, vì vậy chúng ta cần sử dụng lệnh 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"

Chèn Số Trang vào Chân Trang

Một trong những cách sử dụng quan trọng của các đối tượng Header và Footer là hiển thị thông tin số trang và khi sử dụng Aspose.Words Cloud, chúng ta có thể dễ dàng thực hiện yêu cầu này. API cũng cung cấp khả năng chỉ định vị trí cần hiển thị dấu PageNumber. Như được hiển thị trong lệnh bên dưới, chúng tôi đã chỉ định thêm thông tin PageNumber để hiển thị ở vị trí Trên cùng bên phải của trang và cũng hiển thị thông tin đó trên trang đầu tiên của tài liệu.

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"

Tương tự như cập nhật thuộc tính phông chữ cho phiên bản Header, chúng ta cũng có thể cập nhật thuộc tính phông chữ của đối tượng Footer chứa thông tin PageNumber. Vì thông tin số trang bao gồm các đối tượng chạy ba lần (runs/0, runs/2 và runs/3), nên chúng ta cần cập nhật lệnh cập nhật phông chữ ba lần cho mỗi phiên bản chạy.

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"

Sau khi thực hiện tất cả các lệnh trên, tài liệu kết quả sẽ trông tương tự như bản xem trước ở trên.

Để bạn tham khảo, chúng tôi cũng đính kèm các tài liệu mẫu sau: