دستورات cURL یک راه عالی برای انتقال داده با URL است. دستورات cURL برای استفاده از API از پایانه های خط فرمان توصیه می شود. این نه تنها به ما اجازه می‌دهد تا درخواست‌های منظم داشته باشیم، بلکه می‌توانیم داده‌های فرم را ارسال کنیم، کاربران را احراز هویت کنیم، پاسخ‌ها را به فایل‌ها ذخیره کنیم و سایر عملیات دستکاری فایل مرتبط. به عبارت ساده، curl یک ابزار خط فرمان برای انتقال داده ها از یا به یک سرور طراحی شده برای کار بدون تعامل کاربر است. با curl، می توانید داده ها را با استفاده از یکی از پروتکل های پشتیبانی شده از جمله HTTP، HTTPS، SCP، SFTP و FTP دانلود یا آپلود کنید.

با این وجود، آزمایش API های RESTfull را نیز تسهیل می کند.

دستورات cURL استفاده شده است

دریافت کنید

ساده ترین و رایج ترین درخواست/عملیاتی که با استفاده از HTTP انجام می شود، دریافت URL است. هنگام استفاده از این دستور، یک درخواست ارسال می کنیم و منابع را از یک URL خاص (یک سند در مورد ما) بازیابی می کنیم.

ارسال کنید

درخواست پیش‌فرض یک GET است، اما اگر برای ارسال داده‌های فرم‌ها نیاز به استفاده از همان دستور cURL داشته باشیم، باید از درخواست POST استفاده کنیم. بنابراین در این مقاله از همان دستور POST برای ارسال محتوای متنی استفاده خواهیم کرد. لطفاً توجه داشته باشید که برای ارسال داده ها از پارامتر -d (یا – data) با دستور cURL استفاده می کنیم.

قرار دادن

ممکن است به طور تصادفی به یک نیاز برای به روز رسانی داده های موجود برسیم، بنابراین برای این منظور، از یک روش PUT استفاده می شود. برای انجام این نیاز، باید از -X PUT در دستور cURL استفاده کنیم، جایی که X باید با حروف بزرگ باشد.

برای اطلاعات بیشتر، لطفاً به آموزش cURL مراجعه کنید.

توجه: هنگام استفاده از دستورات cURL، مطمئن شوید که بعد از بک اسلش فضای اضافی قرار ندهید، دستور اجرا نمی شود و خطاها نمایش داده می شوند.

راه اندازی cURL در مک

در این مقاله قصد داریم از دستورات cURL در macOS برای درج و به روز رسانی اشیاء Header Footer در سند MS Word با استفاده از یک برنامه ترمینال استفاده کنیم. بنابراین برای شروع، اولین کار نصب cURL در macOS است. برنامه ترمینال را در دسته Others از لانچ پد باز کنید یا Command+Space را فشار دهید و Terminal را تایپ کنید و کلید enter/return را فشار دهید. ساده ترین راه برای نصب cURL استفاده از Homebrew است و به همین دلیل، ابتدا باید homebrew را روی دستگاه مک خود راه اندازی کنید. دستور زیر را در ترمینال خط فرمان تایپ کرده و کلید Enter را فشار دهید.

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

اکنون با استفاده از دستور زیر بسته brew را برای cURL دریافت کنید.

 brew install curl

انجام شد! اکنون می توانید از فر استفاده کنید.

مجوز حساب Aspose.Cloud را صادر کنید

برای شروع کار با Aspose.Cloud APIs، اولین قدم این است که حساب خود را احراز هویت کنید و در پاسخ JWT دریافت کنید. اگر حسابی ندارید، می‌توانید در Aspose.Cloud داشبورد ایجاد کنید یا از طریق حساب Google یا GitHub موجود خود ثبت‌نام کنید و شروع به استفاده از APIهای Cloud ما کنید.

// 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 ارائه می دهد و شما گزینه ای برای استفاده از APIs Cloud، On-Premise APIs یا Cross-platform Apps برای پردازش اسناد Word دریافت می کنید. در این وبلاگ، ما بر روی Cloud API تاکید کرده‌ایم که توانایی ایجاد، دستکاری و تبدیل اسناد MS Word در Cloud را در اختیار ما قرار می‌دهد. برای کار با فایل های MS Word نیازی به دانلود یا نصب نرم افزار خاصی نیست.

خانواده Aspose.Cloud Product مجموعه‌ای از SDK‌های ابری را ارائه می‌کند که زبان‌های برنامه‌نویسی محبوب را هدف قرار می‌دهند، از جمله .NET، Java، PHP، Python، Node.js، Android، C++، [6]S، 6 Ruby. همه این SDK ها در اطراف Aspose.Words Cloud REST API هستند و دستورات cURL یکی از ساده ترین و آسان ترین راه ها برای دسترسی به API های REST از طریق خط فرمان/ترمینال هستند.

در این وبلاگ، ما بر استفاده از دستورات 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
خروجی کنسول هنگام آپلود فایل در فضای ذخیره سازی ابری

پیام موفقیت زمانی که یک فایل در فضای ذخیره سازی ابری آپلود می شود.

اکنون برای تأیید وجود فایل در فضای ذخیره‌سازی ابری، تب My Files را روی dashboard.aspose.cloud باز کنید، می‌توانیم متوجه شویم که پوشه جدیدی به نام InputFolder حاوی BusinessLetter2.docx در لیست ظاهر می‌شود.

پوشه و فایل جدید ایجاد شده در فضای ذخیره سازی ابری آپلود شده است

شی هدر را درج کنید

پس از آپلود سند، می‌توانیم یک شی Header یا Footer جدید وارد کنیم یا به یک شی موجود دسترسی داشته باشیم و ویژگی‌های آن را به‌روزرسانی کنیم. در حال حاضر، Aspose.Words Cloud API از انواع زیر از اشیاء Header و Footer پشتیبانی می کند.

دستور زیر نشان می دهد که چگونه می توان شی HeaderFirst را در سند Word که قبلاً در فضای ذخیره سازی ابری زیر 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 را فهرست می‌کند.

قسمت‌های header و Footer معمولاً حاوی متن، تصاویر و غیره هستند و در دستور زیر می‌خواهیم یک متن نمونه را در داخل پاراگراف اول در داخل شی هدر ایجاد شده در بالا وارد کنیم.

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"

پس از اجرای تمام دستورات بالا، سند حاصل شبیه پیش نمایش بالا خواهد بود.

جهت اطلاع شما، نمونه مدارک نیز پیوست شده است: