تشفير مصنف Excel باستخدام واجهة Aspose.Cells Cloud API – أمثلة لـ cURL و SDK
تقوم هذه الواجهة (REST API) بتشفير مصنف Excel.
المتطلبات المسبقة: يجب أن تمتلك رمز JWT صالحًا، وأن يكون المصنف مُرفَعًا في موقع تخزين قبل استدعاء هذه النقطة النهائية (endpoint).
واجهة PostEncryptDocument
POST https://api.aspose.cloud/v3.0/cells/{name}/encryption
الأمان والمصادقة
تُعد واجهات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معلمات الاستعلام (Query Parameters)
| اسم المعلمة | النوع | مطلوبة | الوصف |
|---|---|---|---|
| folder | string | ✗ | مسار المجلد الذي يحتوي على المصنف الأصلي. |
| storageName | string | ✗ | اسم وحدة التخزين المراد استخدامها. |
معلمة جسم الطلب (Request Body Parameter)
| اسم المعلمة | النوع | مطلوبة | الوصف |
|---|---|---|---|
| encryption | WorkbookEncryptionRequest | ✓ | إعدادات التشفير الخاصة بالمصنف. |
WorkbookEncryptionRequest
| اسم المعلمة | النوع | مطلوبة | الوصف |
|---|---|---|---|
| EncryptionType | string | ✓ | خوارزمية التشفير. انظر الجدول أدناه للاطلاع على القيم المدعومة ومقاصدها. |
| KeyLength | integer | ✗ | طول مفتاح التشفير بالبتات (يُهمل لقيمتَي XOR و Compatible). |
| Password | string | ✓ | كلمة المرور المستخدمة في التشفير. |
قيم EncryptionType
| القيمة | الوصف |
|---|---|
XOR |
خوارزمية XOR البسيطة (قديمة، أمان منخفض). |
Compatible |
تشفير متوافق مع Excel 97‑2003 (بمفتاح 40‑بت). |
EnhancedCryptographicProviderV1 |
AES‑128 مع تجزئة SHA‑1. |
StrongCryptographicProvider |
AES‑256 مع تجزئة SHA‑512 (أقوى خوارزمية مدعومة). |
الاستجابة (Response)
{
"Status":"OK",
"Code":200
}
رموز حالة HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق التشفير بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معلمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبيرة جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | حدث خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostEncryptDocument باستخدام SDKs
مواصفات واجهة PostEncryptDocument
تُعرِّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يُظهر المثال التالي كيفية إجراء استدعاء إلى واجهة Cloud API باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. وتتولى SDK إدارة التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر واجهة الويب باستخدام SDKs مختلفة: