حماية ملف Excel باستخدام واجهة Aspose.Cells Cloud API
تقوم هذه واجهة برمجة التطبيقات REST بـحماية ملف Excel، مما يتيح لك حماية ملف Excel بشكل آمن باستخدام كلمة مرور وخيارات الحماية عبر Aspose.Cells Cloud.
واجهة PostProtectDocument API
POST https://api.aspose.cloud/v3.0/cells/{name}/protection
الأمان والمصادقة
تُعدّ واجهات Aspose.Cells Cloud API آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معلّمات الاستعلام
| اسم المعلّمة | النوع | الوصف |
|---|---|---|
| folder | string | المجلد الذي يحتوي على الملف المطلوب حمايته. (اختياري) |
| storageName | string | اسم موقع التخزين. (اختياري؛ الافتراضي = “Default”) |
معلّمات جسم الطلب
| اسم المعلّمة | النوع | الوصف |
|---|---|---|
| protection | WorkbookProtectionRequest | كائن يُعرّف إعدادات الحماية لملف العمل. |
WorkbookProtectionRequest
| اسم المعلّمة | النوع | الوصف |
|---|---|---|
| ProtectionType | string | نوع الحماية المطلوب تطبيقه. القيم المسموحة (بدون تمييز بين الأحرف الكبيرة والصغيرة): ALL، CONTENTS، NONE، OBJECTS، SCENARIOS، STRUCTURE، WINDOWS. |
| Password | string | كلمة مرور اختيارية لضبطها للحماية. |
الاستجابة
{
"Status":"OK",
"Code":200
}
كود حالات HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | OK (تمت العملية بنجاح) | تمت عملية تطبيق الحماية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب خاطئ) | معلّمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مصادق عليه) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حمولة كبيرة جدًا) | حجم الملف المرفوع يتجاوز الحد المسموح به. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostProtectDocument API باستخدام SDKs
المتطلبات المسبقة
قبل استدعاء واجهة برمجة التطبيقات، تأكّد من تنفيذ الخطوات التالية:
- الحصول على رمز وصول JWT باستخدام سير المصادقة الموضّح في قسم الأمان.
- رفع ملف العمل إلى مساحة التخزين الخاصة بك في Aspose Cloud أو التأكّد من وجوده بالفعل في المجلد المستهدف.
- معرفة اسم مساحة التخزين (الافتراضي هو
"Default"إن لم يُحدّد) واسم الملف الدقيق الذي ترغب في حمايته.
مواصفات واجهة PostProtectDocument API
مواصفات OpenAPI تُعرّف واجهة برمجة تطبيقات متاحة للعامة وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
مثال: حماية ملف Excel باستخدام cURL
-
احصل على رمز وصول كما هو موضّح في المتطلبات المسبقة / المصادقة.
-
نفّذ الطلب:
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/protection?folder=MyFolder&storageName=MyStorage" \ -H "accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <access_token>" \ -d '{ "ProtectionType": "ALL", "Password": "aspose" }'ستتضمن الاستجابة كائن حالة يؤكد نجاح الحماية.
استخدام Aspose.Cells Cloud SDKs
استخدام SDK هو أسرع طريقة لتطوير تطبيقات تتفاعل مع Aspose.Cells Cloud. فالمكتبة SDK تقوم بإخفاء التفاصيل منخفضة المستوى، مما يتيح لك التركيز على منطق تطبيقك. راجع مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر لغات برمجة مختلفة باستخدام SDKs:
استجابة كاملة نموذجية
{
"Status": "OK",
"Code": 200,
"Workbook": {
"Name": "test.xlsx",
"Path": "/MyFolder/test.xlsx",
"Protection": {
"ProtectionType": "ALL",
"Password": true
}
}
}