فتح ملفات إكسل باستخدام واجهة Aspose.Cells Cloud REST API

تقوم هذه الواجهة (REST API) بفتح ملفات إكسل.

واجهة REST API

POST https://api.aspose.cloud/v3.0/cells/unlock

الأمان والمصادقة

تُعتبر واجهات Aspose.Cells Cloud آمنة وتتطلب المصادقة باستخدام رمز JWT.

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
file	ملف	formData (جسم HTTP)	الملف المراد رفعه
password	نص	سلسلة الاستعلام	كلمة المرور لفتح الملف (إن وُجدت)

الاستجابة

{
  "Status":"OK",
  "Code":200
}

كُودات حالة HTTP

الكود	المعنى	الوصف
200	نجاح (OK)	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مُعتمد (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حمل البيانات كبير جدًا (Payload Too Large)	حجم الملف المرفوع يتجاوز الحد المسموح.
500	خطأ داخلي في الخادم (Internal Server Error)	حدث خطأ غير متوقع في الخادم.

كيفية استخدام PostUnlock API باستخدام وحدات التطوير البرمجي (SDKs)

مواصفات PostUnlock API

تُعرّف مواصفات OpenAPI واجهة برمجة قابلة للوصول العام وتتيح لك إجراء تفاعلات REST مباشرة من خلال متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يوضح المثال التالي كيفية إجراء استدعاءات لواجهة Cloud API باستخدام cURL.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/unlock?password=123456" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-F 'xxxxx1=@xxxx1.xlsx' \
-F 'xxxxx2=@xxxx2.xlsx'

الاستجابة

{
  "Files": [
    {
      "Filename": "xxxxx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "xxxxx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

استخدام وحدات التطوير البرمجي (SDKs) لـ Aspose.Cells Cloud

يعتبر استخدام وحدات التطوير البرمجي (SDKs) أفضل طريقة لتسريع عملية التطوير، فهي تتعامل مع التفاصيل منخفضة المستوى وتركز أنت على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بوحدات Aspose.Cells Cloud SDK.

ملاحظات:

يمكن للواجهة فتح عدة ملفات إكسل في طلب واحد؛ ويُعاد كل ملف في مصفوفة Files ضمن الاستجابة.
تأكد من أن إصدار وحدة SDK يتوافق مع إصدار الواجهة (v3.0) لتجنب مشاكل التوافق.

تُظهر أمثلة الشيفرة التالية كيفية إجراء استدعاءات لخدمات ويب Aspose.Cells باستخدام SDKs مختلفة:

إلغاء حماية ملف Excel – واجهة برمجة تطبيقات Aspose.Cells Cloud تعديل حماية كلمة المرور لملف مصنف Excel