حماية دفعات من ملفات Excel

تتيح واجهة REST هذه الحماية الدفعية لملفات Excel المؤهلة.

واجهة REST API

POST http://api.aspose.cloud/v3.0/cells/batch/protect

الأمان والمصادقة

تُعدّ واجهات برمجة التطبيقات (APIs) الخاصة بـ Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
batchProtectRequest	BatchProtectRequest	body	حمولة JSON تحدّد مجلد المصدر، شروط المطابقة، نوع الحماية، كلمة المرور ومجلد الإخراج.

خصائص BatchProtectRequest

الاسم	النوع	الوصف	الملاحظات
SourceFolder	string	المجلد الذي يحتوي على ملفات Excel المصدر.	اختياري
MatchCondition	MatchConditionRequest	المعايير المستخدمة لتحديد الملفات المراد حمايتها.	اختياري
ProtectionType	string	نوع الحماية المراد تطبيقها (مثل `All` أو `ReadOnly`).	اختياري
Password	string	كلمة المرور التي سيتم تعيينها للملفات المحمية.	اختياري
OutFolder	string	المجلد الوجهة للملفات المحمية.	اختياري

خصائص MatchConditionRequest

الاسم	النوع	الوصف	الملاحظات
RegexPattern	string	التعبير النمطي المستخدم لمطابقة أسماء الملفات.	اختياري
FullMatchConditions	string[]	قائمة بشروط أسماء الملفات الدقيقة.	اختياري

معامل جسم الطلب

اسم المعامل	النوع	الوصف
data	file	المحتوى الثنائي لملف المصنّف المراد إنشاؤه.

الاستجابة

{
    "Name": "ResponseFile",
    "DataType": {
        "Identifier": "File",
        "Reference": "Stream",
        "Name": "file"
    }
}

رموز حالة HTTP

الرمز	المعنى	وقت الإرجاع
200 OK	تم إنشاء المصنّف بنجاح	التدفق الطبيعي
201 Created	تم إنشاء المصنّف (استجابة بديلة)	عندما تُعيد واجهة API حالة الإنشاء
400 Bad Request	معاملات غير صالحة	خطأ من جانب العميل
401 Unauthorized	نقص أو عدم صلاحية الرمز	خطأ في المصادقة
409 Conflict	الملف موجود و`isWriteOver=false`	تضارب مع ملف موجود

كيفية استخدام واجهة PostProtectConvert باستخدام واجهات برمجة التطبيقات (SDKs)

مواصفات واجهة PostProtectConvert

تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات مفتوحة ومتاحة للعامة وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يوضح المثال التالي كيفية إجراء استدعاء إلى واجهة API السحابية باستخدام cURL.

Request

curl -v "http://api.aspose.cloud/v3.0/cells/batch/protect" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-D "{\"SourceFolder\":\"CellsTests\",\"OutFolder\":\"Output\",\"MatchCondition\":{\"RegexPattern\":\"(^Book)(.+)(xlsx$)\"},\"Password\":\"123456\",\"ProtectionType\":\"All\"}"

Response

{
  "Code": 200,
  "Status": "OK"
}

استخدام واجهات برمجة التطبيقات (SDKs) الخاصة بـ Aspose.Cells Cloud

استخدام واجهات برمجة التطبيقات (SDKs) هو أفضل طريقة لتسريع التطوير. فتتولى واجهة SDK إدارة التفاصيل من المستوى المنخفض وتتيح لك التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للاطّلاع على قائمة كاملة بواجهات برمجة التطبيقات (SDKs) الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية إجراء استدعاءات إلى خدمات الويب الخاصة بـ Aspose.Cells باستخدام واجهات برمجة التطبيقات (SDKs) المختلفة: