cURL 명령은 URL을 사용하여 데이터를 전송하는 훌륭한 방법입니다. cURL 명령은 명령줄 터미널에서 API를 사용하는 것이 좋습니다. 정기적인 요청을 할 수 있을 뿐만 아니라 양식 데이터를 게시하고, 사용자를 인증하고, 파일에 대한 응답을 저장하고, 기타 관련 파일 조작 작업을 할 수도 있습니다. 간단히 말해서, curl은 사용자 상호 작용 없이 작동하도록 설계된 서버에서 데이터를 전송하거나 서버로 데이터를 전송하기 위한 명령줄 유틸리티입니다. curl을 사용하면 HTTP, HTTPS, SCP, SFTP, FTP를 포함한 지원되는 프로토콜 중 하나를 사용하여 데이터를 다운로드하거나 업로드할 수 있습니다.

그럼에도 불구하고, 이를 통해 RESTfull API를 테스트하는 것도 쉬워집니다.

사용된 cURL 명령

얻다

HTTP를 사용하여 만든 가장 간단하고 가장 일반적인 요청/작업은 URL을 GET하는 것입니다. 이 명령을 사용할 때, 우리는 요청을 보내고 특정 URL(우리의 경우 문서)에서 리소스를 검색합니다.

우편

기본 요청은 GET이지만, 양식 데이터를 제출하기 위해 동일한 cURL 명령을 사용해야 하는 경우 POST 요청을 사용해야 합니다. 따라서 이 문서에서는 동일한 POST 명령을 사용하여 텍스트 콘텐츠를 제출합니다. 데이터를 게시하려면 cURL 명령과 함께 -d(또는 – data) 매개변수를 사용합니다.

놓다

기존 데이터를 업데이트해야 하는 요구 사항에 부딪힐 수 있으므로, 그 목적으로 PUT 메서드가 사용됩니다. 이 요구 사항을 달성하려면 cURL 명령에서 -X PUT을 사용해야 하며, 여기서 X는 대문자여야 합니다.

자세한 내용은 cURL 튜토리얼을 방문하세요.

참고: cURL 명령을 사용할 때 백슬래시() 뒤에 공백을 넣지 않도록 주의하세요. 그렇지 않으면 명령이 실행되지 않고 오류가 표시됩니다.

Mac에서 cURL 설정하기

이 글에서는 macOS에서 cURL 명령을 사용하여 터미널 애플리케이션을 사용하여 MS Word 문서에 Header Footer 객체를 삽입하고 업데이트합니다. 시작하려면 먼저 macOS에 cURL을 설치해야 합니다. 런치패드에서 Others 범주에 있는 Terminal 애플리케이션을 열거나 Command+Space를 누르고 Terminal을 입력한 다음 enter/return 키를 누릅니다. 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 계정을 통해 가입하고 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 클라우드

Aspose는 MS Word 문서를 조작하는 API를 제공하며, 클라우드 API, 온프레미스 API 또는 크로스 플랫폼 앱을 사용하여 Word 문서를 처리하는 옵션이 제공됩니다. 이 블로그에서는 클라우드에서 MS Word 문서를 만들고, 조작하고, 변환하는 기능을 제공하는 클라우드 API를 강조했습니다. MS Word 파일을 작업하는 데 특정 소프트웨어 다운로드나 설치가 필요하지 않습니다.

Aspose.Cloud 제품군은 .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift 및 Go를 비롯한 인기 있는 프로그래밍 언어를 타겟으로 하는 클라우드 SDK 세트를 제공합니다. 이러한 모든 SDK는 Aspose.Words Cloud REST API를 감싸는 래퍼이며 cURL 명령은 명령 프롬프트/터미널을 통해 REST API에 액세스하는 가장 간단하고 쉬운 방법 중 하나입니다.

이 블로그에서는 Aspose.Words Cloud API에 액세스하는 동안 MS Word 파일 내의 헤더 및 푸터 섹션을 조작하기 위해 cURL 명령을 사용하는 방법에 중점을 둡니다.

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에서 내 파일 탭을 열면 BusinessLetter2.docx가 포함된 InputFolder라는 새 폴더가 목록에 나타나는 것을 볼 수 있습니다.

새로 생성된 폴더와 파일이 클라우드 스토리지에 업로드됨

헤더 객체 삽입

문서를 업로드한 후, 새로운 Header 또는 Footer 객체를 삽입하거나 기존 객체에 액세스하여 속성을 업데이트할 수 있습니다. 현재 Aspose.Words Cloud API는 다음 유형의 Header 및 Footer 객체를 지원합니다.

다음 명령은 클라우드 저장소에 이미 있는 Word 문서의 InputFolder 아래에 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 객체의 글꼴 속성도 업데이트할 수 있습니다. 페이지 번호 정보는 세 개의 run 객체(runs/0, runs/2, runs/3)로 구성되므로 각 run 인스턴스에 대해 글꼴 업데이트 명령을 세 번 업데이트해야 합니다.

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"

위의 명령을 모두 실행하면 결과 문서는 위의 미리보기와 비슷하게 표시됩니다.

참고용으로 샘플 문서도 첨부하였습니다.