كيفية فك تشفير ملف Excel باستخدام واجهة Aspose.Cells Cloud API
Contents
[
Hide
]
المتطلبات الأساسية
- رمز وصول JWT صالح.
- يجب أن يكون الملف المحمي ببيانات سرية قد تم رفعه إلى مساحة تخزين Aspose Cloud مع تحديد مساره في معامل الاستعلام
folder.
واجهة DeleteDecryptWorkbook API
DELETE https://api.aspose.cloud/v3.0/cells/{name}/encryption
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الاستعلام
| اسم المعامل | النوع | الوصف |
|---|---|---|
| folder | string | مسار المجلد الذي يوجد فيه ملف Excel الأصلي. |
| storageName | string | اسم مساحة التخزين التي يوجد فيها ملف Excel. |
معامل جسم الطلب
| اسم المعامل | النوع | الوصف |
|---|---|---|
| encryption | WorkbookEncryptionRequest | إعدادات التشفير المطلوبة لفك التشفير. |
WorkbookEncryptionRequest
| اسم المعامل | النوع | الوصف |
|---|---|---|
| EncryptionType | string | خوارزمية التشفير (XOR, Compatible, EnhancedCryptographicProviderV1, StrongCryptographicProvider). |
| KeyLength | integer | طول مفتاح التشفير بالبتات. |
| Password | string | كلمة المرور المستخدمة لفك التشفير. |
الاستجابة
{
"Status":"OK",
"Code":200
}
** أمثلة على استجابات الأخطاء**
{
"Code": "400",
"Message": "معاملات طلب غير صالحة."
}
{
"Code": "401",
"Message": "فشل المصادقة. رمز JWT غير صالح أو مفقود."
}
{
"Code": "413",
"Message": "حجم البيانات كبير جدًا. تجاوز الملف المرفوع الحد المسموح به."
}
{
"Code": "500",
"Message": "خطأ داخلي في الخادم. يُرجى المحاولة مرة أخرى لاحقًا."
}
رموز حالة HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صالحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مخوّل (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم البيانات كبير جدًا (Payload Too Large) | تجاوز الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة DeleteDecryptWorkbook API باستخدام حزم التطوير (SDKs)
مواصفات واجهة DeleteDecryptWorkbook API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام cURL للوصول إلى خدمات Aspose.Cells بسهولة. يوضح المثال التالي كيفية استدعاء واجهة Cloud API باستخدام cURL.