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

ჩვენ შეიძლება წავაწყდეთ არსებული მონაცემების განახლების მოთხოვნას, ამიტომ ამ მიზნით გამოიყენება PUT მეთოდი. ამ მოთხოვნის შესასრულებლად, ჩვენ უნდა გამოვიყენოთ -X PUT cURL ბრძანებაში, სადაც X უნდა იყოს დიდი ასოებით.

დამატებითი ინფორმაციისთვის ეწვიეთ cURL tutorial.

შენიშვნა: cURL ბრძანებების გამოყენებისას, დარწმუნდით, რომ არ დადოთ დამატებითი სივრცე უკანა ხაზის შემდეგ \ else, ბრძანება არ შესრულდება და შეცდომები გამოჩნდება.

cURL-ის დაყენება Mac-ზე

ამ სტატიაში ჩვენ ვაპირებთ გამოვიყენოთ cURL ბრძანებები macOS-ზე Header Footer ობიექტების ჩასასმელად და განახლებისთვის MS Word დოკუმენტში ტერმინალის აპლიკაციის გამოყენებით. ასე რომ, დასაწყებად, პირველია დააინსტალიროთ cURL macOS-ზე. გახსენით ტერმინალის აპლიკაცია სხვათა კატეგორიის ქვეშ, გაშვების პანელიდან ან დააჭირეთ Command+Space და ჩაწერეთ Terminal და დააჭირეთ 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 dashboard-ზე ან დარეგისტრირდეთ თქვენი არსებული 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 ან, Cross-platform Apps Word დოკუმენტების დასამუშავებლად. ამ ბლოგში ჩვენ ხაზგასმით აღვნიშნეთ Cloud API-ებზე, რომლებიც გვაძლევენ შესაძლებლობას შევქმნათ, მანიპულიროთ და გარდაქმნათ MS Word დოკუმენტები ღრუბელში. არ არის საჭირო კონკრეტული პროგრამული უზრუნველყოფის ჩამოტვირთვა ან ინსტალაცია MS Word ფაილებთან მუშაობისთვის.

Aspose.Cloud Product-ის ოჯახი უზრუნველყოფს ღრუბლოვანი SDK-ების კომპლექტს, რომლებიც მიზნად ისახავს პროგრამირების პოპულარულ ენებს, მათ შორის .NET, Java, PHP, Python, Node.js, Android, C++, 6 Ruby. ყველა ეს SDK არის შეფუთვა გარშემო Aspose.Words Cloud REST API და cURL ბრძანებები არის ერთ-ერთი უმარტივესი და მარტივი გზა REST API-ებზე წვდომისთვის ბრძანების სტრიქონზე/ტერმინალზე.

ამ ბლოგში ჩვენ ხაზს ვუსვამთ cURL ბრძანებების გამოყენებას Header და Footer განყოფილებით 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-ში ატვირთვისას

წარმატების შეტყობინება, როდესაც ფაილი იტვირთება ღრუბლოვან საცავში.

ახლა იმისათვის, რომ დაადასტუროთ ფაილის არსებობა ღრუბლოვან საცავში, გახსენით My Files ჩანართი dashboard.aspose.cloud-ზე, შეგვიძლია შევამჩნიოთ, რომ სიაში გამოჩნდება ახალი საქაღალდე სახელად InputFolder, რომელიც შეიცავს BusinessLetter2.docx-ს.

Cloud Storage-ზე ატვირთული ახლად შექმნილი საქაღალდე და ფაილი

Header ობიექტის ჩასმა

დოკუმენტის ატვირთვის შემდეგ, ჩვენ შეგვიძლია ჩავსვათ ახალი Header ან Footer ობიექტი, ან შევიდეთ არსებულ ობიექტზე და განვაახლოთ მისი თვისებები. ამჟამად, Aspose.Words Cloud API მხარს უჭერს Header და Footer ობიექტების შემდეგ ტიპებს.

შემდეგი ბრძანება გვიჩვენებს, თუ როგორ უნდა ჩასვათ HeaderFirst ობიექტი Word დოკუმენტში, რომელიც უკვე ხელმისაწვდომია Cloud საცავში 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"
წარწერა

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

განაახლეთ Header ობიექტის ტექსტური ფორმატირება

ტექსტის ჩასმის შემდეგ ჩვენ შეგვიძლია განვაახლოთ ტექსტის შრიფტის თვისებები. ვინაიდან Word დოკუმენტი შეიძლება შეიცავდეს ბევრ ტექსტურ ინსტანციას, ამიტომ ტექსტის განახლებისთვის, ჩვენ უნდა მივაწოდოთ ზუსტი გზა. ასე რომ, თუ გვჭირდება შრიფტის თვისებების განახლება ზემოთ ჩასმული ტექსტისთვის, რომელიც ჩასმულია განყოფილებებში/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"

ყველა ზემოაღნიშნული ბრძანების შესრულების შემდეგ, შედეგად მიღებული დოკუმენტი ზემოთ მოცემული გადახედვის მსგავსი იქნება.

ცნობისთვის, ასევე თან ერთვის საბუთების ნიმუში: