أوامر cURL هي طريقة ممتازة لنقل البيانات باستخدام عناوين URL. يوصى باستخدام أوامر cURL لاستخدام واجهات برمجة التطبيقات من محطات سطر الأوامر. فهي لا تسمح لنا فقط بتقديم طلبات منتظمة، بل يمكننا أيضًا نشر بيانات النماذج، ومصادقة المستخدمين، وحفظ الاستجابات للملفات وعمليات معالجة الملفات الأخرى ذات الصلة. وبكلمات بسيطة، curl هي أداة مساعدة لسطر الأوامر لنقل البيانات من أو إلى خادم مصممة للعمل بدون تفاعل المستخدم. باستخدام curl، يمكنك تنزيل أو تحميل البيانات باستخدام أحد البروتوكولات المدعومة بما في ذلك HTTP وHTTPS وSCP وSFTP وFTP.

ومع ذلك، فهو يسهل علينا أيضًا اختبار واجهات برمجة التطبيقات RESTfull.

أوامر cURL المستخدمة

يحصل

إن أبسط طلب/عملية يتم إجراؤها باستخدام HTTP هي الحصول على عنوان URL. عند استخدام هذا الأمر، نرسل طلبًا ونسترد الموارد من عنوان URL محدد (مستند في حالتنا).

بريد

الطلب الافتراضي هو GET ولكن إذا كان لدينا متطلب لاستخدام نفس أمر cURL لإرسال بيانات النماذج، فنحن بحاجة إلى استخدام طلب POST. لذلك، في هذه المقالة، سنستخدم نفس أمر POST لإرسال محتوى نصي. يرجى ملاحظة أنه لنشر البيانات، نستخدم معلمة -d (أو – data) مع أمر cURL.

يضع

قد نصادف متطلبًا لتحديث البيانات الموجودة، لذا يتم استخدام طريقة PUT لهذا الغرض. ولإنجاز هذا المتطلب، نحتاج إلى استخدام -X PUT في أمر cURL حيث يجب أن يكون X بأحرف كبيرة.

لمزيد من المعلومات، يرجى زيارة cURL tutorial.

ملاحظة: عند استخدام أوامر cURL، تأكد من عدم وضع مسافة إضافية بعد الشرطة المائلة للخلف \ وإلا فلن يتم تنفيذ الأمر وسيتم عرض الأخطاء.

إعداد cURL على Mac

في هذه المقالة، سنستخدم أوامر cURL على نظام macOS لإدراج وتحديث كائنات الرأس والتذييل داخل مستند MS Word باستخدام تطبيق طرفي. لذا، للبدء، أول شيء هو تثبيت cURL على نظام macOS. افتح تطبيق Terminal ضمن فئة Others من لوحة التشغيل أو اضغط على Command+Space واكتب Terminal واضغط على مفتاح الإدخال/الرجوع. أسهل طريقة لتثبيت cURL هي استخدام Homebrew ولهذا السبب، تحتاج أولاً إلى إعداد homebrew على جهاز Mac الخاص بك. اكتب الأمر التالي في محطة سطر الأوامر واضغط على مفتاح الإدخال.

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 والبدء في استخدام واجهات برمجة التطبيقات السحابية الخاصة بنا.

// 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

توفر Aspose واجهات برمجة تطبيقات لمعالجة مستندات MS Word، ويمكنك استخدام واجهات برمجة تطبيقات السحابة أو واجهات برمجة تطبيقات محلية أو تطبيقات متعددة الأنظمة لمعالجة مستندات Word. في هذه المدونة، ركزنا على واجهات برمجة تطبيقات السحابة التي توفر لنا الإمكانيات اللازمة لإنشاء مستندات MS Word ومعالجتها وتحويلها في السحابة. لا يلزم تنزيل أو تثبيت برنامج معين للعمل مع ملفات MS Word.

توفر عائلة منتجات Aspose.Cloud مجموعة من حزم SDK السحابية التي تستهدف لغات البرمجة الشائعة بما في ذلك .NET وJava وPHP وPython وNode.js وAndroid وC++ وRuby وSwift وGo. كل حزم SDK هذه عبارة عن غلاف حول Aspose.Words Cloud REST API وأوامر cURL هي واحدة من أبسط وأسهل الطرق للوصول إلى واجهات برمجة تطبيقات REST عبر موجه الأوامر/المحطة الطرفية.

في هذه المدونة، نركز على استخدام أوامر cURL للتعامل مع قسم الرأس والتذييل داخل ملفات 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
إخراج وحدة التحكم عند تحميل الملف إلى التخزين السحابي

رسالة نجاح عند تحميل ملف إلى التخزين السحابي.

الآن لتأكيد وجود الملف على التخزين السحابي، افتح علامة التبويب ملفاتي على dashboard.aspose.cloud، يمكننا أن نلاحظ ظهور مجلد جديد باسم InputFolder يحتوي على BusinessLetter2.docx في القائمة.

تم إنشاء مجلد وملف جديدين وتم تحميلهما على التخزين السحابي

إدراج كائن الرأس

بعد تحميل المستند، يمكننا إما إدراج كائن رأس أو تذييل جديد أو الوصول إلى كائن موجود وتحديث خصائصه. حاليًا، تدعم واجهة برمجة تطبيقات Aspose.Words Cloud الأنواع التالية من كائنات الرأس والتذييل.

يوضح الأمر التالي كيفية إدراج كائن 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.

عادةً ما تحتوي أقسام الرأس والتذييل على نصوص وصور وما إلى ذلك، وفي الأمر التالي، سنقوم بإدراج نص نموذجي داخل الفقرة الأولى داخل كائن الرأس الذي تم إنشاؤه أعلاه.

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.

تحديث تنسيق النص لكائن الرأس

بمجرد إدراج النص، يمكننا تحديث خصائص خط النص. نظرًا لأن مستند 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"

إدراج رقم الصفحة في التذييل

أحد الاستخدامات المهمة لكائنات الرأس والتذييل هو عرض معلومات رقم الصفحة، وبينما نستخدم Aspose.Words Cloud، يمكننا بسهولة تحقيق هذا المطلب. توفر واجهة برمجة التطبيقات أيضًا الإمكانيات لتحديد الموقع الذي يجب عرض ختم 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، يمكننا أيضًا تحديث خصائص الخط لكائن 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"

بمجرد تنفيذ كافة الأوامر المذكورة أعلاه، ستبدو الوثيقة الناتجة مشابهة للمعاينة أعلاه.

لمزيد من المعلومات، نرفق أيضًا المستندات النموذجية: