قفل ملفات Excel – مستندات واجهة Aspose.Cells Cloud API

إصدار API: v3.0 (الإصدار الحالي)

تقوم هذه واجهة REST API بقفل كتب عمل Excel.

واجهة PostLock API

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

المتطلبات المسبقة – يجب إرسال الطلب عبر بروتوكول HTTPS، ويتضمن رمز مميز (Bearer token) ساري المفعول من نوع OAuth 2.0 في رأس الطلب Authorization.

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

اسم المعامل	النوع	الموقع	الوصف
file	ملف	بيانات النموذج (multipart body)	كتاب عمل Excel المراد رفعه وقفله.
password	نص (string)	سلسلة الاستعلام (query string)	كلمة المرور لكتاب العمل (اختيارية).

مواصفات OpenAPI تعرّف واجهة برمجة تطبيقات متاحة عمومًا، وتتيح لك تنفيذ تفاعلات REST مباشرة من متصفح الويب.

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/lock?password=123456" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -F "file=@Sample.xlsx"

الاستجابة

{
  "Files": [
    {
      "Filename": "Sample.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

يمكنك تنزيل كتاب عمل تجريبي — Sample.xlsx — لاختبار الطلب.

ملاحظة: تدعم الواجهة ملفات بحجم يصل إلى 100 ميغابايت؛ قد تؤدي الحمول الأكبر إلى استجابة برمز الخطأ 413 (Payload Too Large / حمل البيانات كبير جدًا).

تفاصيل الاستجابة

الحقل	النوع	الوصف
Filename	نص (string)	اسم كتاب العمل المُقفل الذي تعيده الخدمة.
FileSize	عدد صحيح (integer)	حجم الملف المقفل بالبايت.
FileContent	نص (Base64)	كتاب العمل المقفل مشفرًا على هيئة سلسلة Base64.

للحصول على كتاب العمل المقفل، قم بفك تشفير القيمة FileContent من تنسيق Base64 واحفظه باستخدام الاسم المحدد في الحقل Filename ضمن الاستجابة.

معالجة الأخطاء

– تُعيد الواجهة رموز حالة HTTP القياسية (مثل 400 Bad Request، 401 Unauthorized، 500 Internal Server Error) مع كائن خطأ بصيغة JSON يحتوي على حقلين: Code و Message.

عائلة SDK للحُوسبة السحابية

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

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

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