إزالة حماية كلمة المرور من ملفات Excel – فتح كلمات المرور للفتح والتعديل فورًا
تقوم واجهة برمجة تطبيقات إلغاء حماية جدول البيانات بإزالة حماية كلمات المرور للفتح والتعديل من ملفات Excel في استدعاء واحد فقط. وهي مثالية لسُلُكَات البيانات، وأنظمة إدارة المستندات، وسير عمل النقل.
واجهة برمجة تطبيقات إلغاء حماية جدول البيانات
واجهة برمجة التطبيقات على الويب
PUT https://api.aspose.cloud/v4.0/cells/unprotection/spreadsheet
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
-H "Authorization: Bearer {access_token}"
معلمات الطلب
| اسم المعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| Spreadsheet | ملف | FormData | ملف Excel الذي سيتم إلغاء حمايته. |
| password | نص | استعلام | كلمة المرور التي تحمي الملف ضد الفتح. |
| modifyPassword | نص | استعلام | كلمة المرور المطلوبة لتعديل الملف (اختيارية إذا كانت مُعيّنة كلمة مرور فتح فقط). |
| outPath | نص | استعلام | (اختياري) مسار المجلد الذي سيتم حفظ الملف غير المحمي فيه. |
| outStorageName | نص | استعلام | (اختياري) اسم وحدة التخزين التي سيتم كتابة الملف الناتج فيها. |
| region | نص | استعلام | (اختياري) إعدادات منطقة جدول البيانات. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
]
تُعيد الاستجابة الناجحة ملف غير محمي كتيار بيانات (stream). ويمكن حفظ الملف في الموقع المحدّد بواسطة outPath وoutStorageName، أو استرجاعه مباشرةً من حمولة الاستجابة.
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معلمات ناقصة أو غير صحيحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مُصادَق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حمولة كبيرة جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
متى يجب استخدام واجهة برمجة تطبيقات إلغاء حماية جدول البيانات؟
- استعادة الوصول إلى الملفات المُقفلة – أزِل كلمات المرور المنسية للفتح أو التعديل بسرعة دون تدخل يدوي.
- أتمتة فتح الدُّفعات – عالِج كميات كبيرة من الملفات في مشاريع نقل البيانات أو الأرشفة.
- التكامل مع سير العمل الحالي – اجمعها مع واجهات برمجة تطبيقات التخزين أو التحويل لإنشاء سير عمل متكامل (مثل: رفع → إلغاء الحماية → تحويل إلى PDF).
- الحفاظ على أمن البيانات – تتم العملية من جانب الخادم، مما يضمن أمان الملفات الأصلية بينما يُخزّن النسخة غير المحمية في مساحة التخزين السحابية الخاصة بك.
كيفية استخدام واجهة برمجة تطبيقات إلغاء حماية جدول البيانات باستخدام مكتبات SDK
مواصفات OpenAPI
توفّر مواصفات واجهة برمجة تطبيقات إلغاء حماية جدول البيانات واجهة برمجة برمجية متاحة عمومًا لتسهيل التفاعل المباشر مع REST من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. ويُظهر المثال التالي كيفية إرسال استدعاءات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
استخدام مكتبة SDK يبسّط الاستدعاء من خلال معالجة المصادقة، وبناء الطلب، وتحليل الاستجابة. وتُوفَّر مكتبات SDK لعدة لغات برمجة، وتشمل طُرقًا جاهزة لإلغاء حماية جداول البيانات.
تُظهر الأمثلة التالية كيفية استدعاء واجهة برمجة تطبيقات إلغاء حماية جدول البيانات باستخدام مكتبات SDK مختلفة: