قفل دفعات من ملفات إكسل
تتيح واجهة برمجة التطبيقات هذه قفل دفعات من ملفات إكسل المؤهلة.
واجهة برمجة التطبيقات REST
POST http://api.aspose.cloud/v3.0/cells/batch/lock
الأمان والمصادقة
واجهات برمجة التطبيقات السحابية الخاصة بـ Aspose.Cells آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| BatchLockRequest | BatchLockRequest | body | جسم JSON يحتوي على معاملات القفل. |
خصائص BatchLockRequest
| الاسم | النوع | الوصف | الملاحظات |
|---|---|---|---|
| SourceFolder | string | المجلد الذي يحتوي على ملفات إكسل المصدر. | اختياري |
| MatchCondition | MatchConditionRequest | الشروط المستخدمة لاختيار الملفات المراد قفلها. | اختياري |
| Password | string | كلمة المرور المطلوب تطبيقها على الملفات المُقفلة. | اختياري |
| OutFolder | string | المجلد الوجهة للملفات المُقفلة. | اختياري |
خصائص MatchConditionRequest
| الاسم | النوع | الوصف | الملاحظات |
|---|---|---|---|
| RegexPattern | string | نمط تعبير عادي (regex) لمطابقة أسماء الملفات. | اختياري |
| FullMatchConditions | string[] | أسماء ملفات مطابقة تامة لعملية القفل. | اختياري |
معامل جسم الطلب
| اسم المعامل | النوع | الوصف |
|---|---|---|
| data | file | المحتوى الثنائي لملف المصنف المراد إنشاؤه. |
الاستجابة
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
رموز حالة HTTP
| الرمز | المعنى | وقت العودة |
|---|---|---|
| 200 OK | تم إنشاء المصنف بنجاح | التدفق الطبيعي |
| 201 Created | تم إنشاء المصنف (استجابة بديلة) | عند عودة الواجهة بحالة “تم الإنشاء” |
| 400 Bad Request | معاملات غير صالحة | خطأ من جانب العميل |
| 401 Unauthorized | نقص أو وجود رمز غير صالح | خطأ في المصادقة |
| 409 Conflict | وجود الملف بالفعل و isWriteOver=false |
تضارب مع ملف موجود |
كيفية استخدام واجهة PostBatchLock API باستخدام حزم تطوير البرامج (SDKs)
مواصفات واجهة PostBatchLock API
تعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول علنًا وتتيح لك إجراء تفاعلات REST مباشرةً من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يوضح المثال التالي كيفية استدعاء واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام حزم تطوير البرامج (SDKs) الخاصة بـ Aspose.Cells Cloud
استخدام حزمة تطوير البرامج (SDK) هو أسرع طريقة للتطوير. فتقوم الحزمة بإخفاء التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام القفل الخاصة بك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرامج الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose.Cells باستخدام مكتبات مختلفة: