تعديل حماية كلمة المرور لملف مصنف Excel – Aspose.Cells Cloud
تقوم هذه الواجهة بتغيير كلمة مرور الحماية ضد الكتابة لمصنف Excel موجود مسبقًا.
يتيح تحديث كلمة مرور الحماية ضد الكتابة برمجيًا تدوير كلمات المرور أو استبدالها دون تنزيل الملف. وهي مفيدة جدًا عند إدارة المصنفات المؤمنة المخزنة في مساحة التخزين الخاصة بـ Aspose.Cells Cloud.
واجهة REST API
PUT https://api.aspose.cloud/v3.0/cells/{name}/writeProtection
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | نص (string) | المسار (path) | اسم ملف مصنف Excel (مطلوب). |
| password | نص (string) | الجسم (body) بصيغة JSON | كلمة مرور الحماية ضد الكتابة الجديدة المراد تعيينها (مطلوب). |
| folder | نص (string) | الاستعلام (query) | المجلد اختياري حيث يُخزَّن المصنف. |
| storageName | نص (string) | الاستعلام (query) | اسم خدمة التخزين اختياري. |
الاستجابة
{
"Status":"OK",
"Code":200
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصرّح (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PutDocumentProtectFromChanges باستخدام SDKs
مواصفات واجهة PutDocumentProtectFromChanges
تُعرّف مواصفات OpenAPI الواجهة البرمجية العامة المُتاحة التي تسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يوضح أمر cURL أدناه كيفية استدعاء واجهة Cloud API.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة لتطوير التطبيقات. تُتعامل SDKs مع التفاصيل منخفضة المستوى، مما يتيح لك التركيز على المنطق التجاري. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose.Cells باستخدام SDKs مختلفة: