إلغاء حماية ملف Excel – واجهة برمجة تطبيقات Aspose.Cells Cloud
Contents
[
Hide
]
استخدم هذه واجهة برمجة تطبيقات REST لإلغاء حماية ملف عمل Excel.
DeleteUnProtectWorkbook API
DELETE https://api.aspose.cloud/v3.0/cells/{name}/protection
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات المسار (Path Parameters)
| المعامل | النوع | الوصف | الإجباري |
|---|---|---|---|
| name | string | اسم ملف ملف العمل (مع امتداد الملف). | نعم |
معاملات الاستعلام (Query Parameters)
| اسم المعامل | النوع | الوصف |
|---|---|---|
| folder | string | مسار المجلد الذي يحتوي على ملف العمل الأصلي. |
| storageName | string | اسم خدمة التخزين التي يخزن فيها ملف العمل. |
معاملات جسم الطلب (Request Body Parameters)
| اسم المعامل | النوع | الوصف |
|---|---|---|
| protection | WorkbookProtectionRequest | كائن يحدد إعدادات الحماية المراد إزالتها. |
WorkbookProtectionRequest
| اسم المعامل | النوع | الوصف |
|---|---|---|
| ProtectionType | string | نوع الحماية المراد إزالتها (ALL، CONTENTS، NONE، OBJECTS، SCENARIOS، STRUCTURE، WINDOWS). |
| Password | string | كلمة المرور المطلوبة لإزالة الحماية (اختيارية). |
مثال cURL
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/test.xlsx/protection?folder=MyFolder&storageName=MyStorage" \
-H "Authorization: Bearer <access_token>" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-d '{ "ProtectionType": "ALL", "Password": "aspose"}'
الاستجابة (ناجحة)
{
"Code": 200,
"Status": "OK"
}
استجابات الأخطاء (HTTPS Status Error Responses)
| حالة HTTP | الكود | الوصف |
|---|---|---|
| 400 | BadRequest | معاملات مفقودة أو غير صالحة. |
| 401 | Unauthorized | رمز وصول غير صالح أو مفقود. |
| 404 | NotFound | لم يتم العثور على ملف العمل المحدد في المجلد/خدمة التخزين المعطاة. |
| 500 | InternalServerError | خطأ غير متوقع في الخادم. |
كيفية استخدام DeleteUnProtectWorkbook API باستخدام مكتبات SDK
مواصفات DeleteUnProtectWorkbook API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب Aspose.Cells. يُظهر المثال التالي كيفية إجراء مكالمات لواجهة برمجة تطبيقات السحابة باستخدام cURL.
استخدام مكتبات SDK لـ Aspose.Cells Cloud
استخدام SDK يبسّط التكامل ويقلّل من كمية الكود المتكرر. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK لـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK متنوعة: