حماية ملفات Excel

تقوم هذه واجهة برمجة تطبيقات REST بحماية ملفات Excel.

واجهة برمجة تطبيقات REST

POST http://api.aspose.cloud/v3.0/cells/protect

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

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

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

اسم المعامل	النوع	الموقع	الوصف
file	ملف	formData (body)	الملف المرفوع
password	نص	سلسلة الاستعلام (`password`)	كلمة المرور المستخدمة لحماية المصنف

الاستجابة

{
  "Status":"OK",
  "Code":200,
  "Files": [
    {
      "Filename": "اسم الملف المحمي: smaple1.xlsx",
      "FileSize": الحجم,
      "FileContent": "-----سلسلة Base64 لملف sample1-----"
    },
    {
      "Filename": "اسم الملف المحمي: sample2.xlsx",
      "FileSize": الحجم,
      "FileContent": "-----سلسلة Base64 لملف sample2-----"
    }
  ]
}

رموز حالة HTTP

الكود	المعنى	الوصف
200	نجاح	تم تطبيق الحماية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مصرّح به	رمز JWT غير صالح أو مفقود.
413	حمل البيانات كبير جدًا	تجاوز حجم الملف المرفوق الحد المسموح.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

كيفية استخدام واجهة PostProtect API مع SDKs

مواصفات واجهة PostProtect API

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

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

الطلب

curl -v "http://api.aspose.cloud/v3.0/cells/protect?password=MySecretPwd" \
  -X POST \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F 'file1=@sample1.xlsx' \
  -F 'file2=@sample2.xlsx'

الاستجابة

{
  "Files": [
    {
      "Filename": "sample1.xlsx",
      "FileSize": 274022,
      "FileContent": "-----سلسلة Base64 لملف sample1-----"
    },
    {
      "Filename": "sample2.xlsx",
      "FileSize": 274022,
      "FileContent": "-----سلسلة Base64 لملف sample2-----"
    }
  ]
}

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

– يمكن أن تُعيد واجهة برمجة التطبيقات رموز الحالة التالية:

رمز HTTP	المعنى	محتوى خطأ JSON مثال
400	طلب غير صالح (مثل ملف مفقود)	`{"Code":400,"Message":"الملف مطلوب."}`
401	غير مصرّح به (رمز غير صالح أو مفقود)	`{"Code":401,"Message":"رمز الوصول غير صالح."}`
403	ممنوع (صلاحيات غير كافية)	`{"Code":403,"Message":"تم رفض الوصول."}`
500	خطأ داخلي في الخادم	`{"Code":500,"Message":"خطأ غير متوقع في الخادم."}`

استخدام SDKs لـ Aspose.Cells Cloud

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

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

إضافة توقيع رقمي إلى كتاب عمل Excel فك تشفير ملف Excel