أتمتة حماية كلمات المرور في Excel على نطاق واسع باستخدام واجهة برمجة التطبيقات الخاصة بنا للمطورين — تطبيق كلمتي المرور (للفتح والتعديل) برمجيًا. مثالية لسير العمل المؤسسية وتوافقية مع تنسيقات .xlsx والتنسيقات القديمة. احصل على الوثائق وابدأ تكاملك المجاني اليوم.
واجهة برمجة تطبيقات حماية ورقة العمل
واجهة برمجة التطبيقات الويب (Web API)
PUT https://api.aspose.cloud/v4.0/cells/protection/spreadsheet
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
-H "Authorization: Bearer {access_token}"
مُعَيَّنات الطلب (Request Parameters):
| اسم المُعَيّن | النوع | المسار / سلسلة الاستعلام / جسم HTTP | الوصف |
|---|---|---|---|
| Spreadsheet | ملف | FormData | ملف ورقة عمل Excel المراد رفعه وحمايته بتشفير بكلمة مرور. |
| openPassword | نص (String) | استعلام (Query) | كلمة المرور المطلوبة لفتح (فك تشفير) ورقة العمل المحمية. |
| modifyPassword | نص (String) | استعلام (Query) | كلمة المرور المطلوبة لتمكين التعديل أو إجراء تغييرات على محتويات ورقة العمل. |
| outPath | نص (String) | استعلام (Query) | (اختياري) يُحدِّد مسار مجلد الإخراج حيث سيتم حفظ كتاب العمل المحمي. إن لم يُحدَّد، سيُعاد الملف في استجابة الطلب. |
| outStorageName | نص (String) | استعلام (Query) | اسم التخزين السحابي المستخدم لحفظ ملف كتاب العمل المحمي الناتج. |
| region | نص (String) | استعلام (Query) | يُحدِّد الإعدادات الإقليمية/الثقافية (مثل تنسيق التاريخ، وتنسيق الأرقام) التي سيتم تطبيقها على ورقة العمل أثناء المعالجة. |
المصادقة
تتطلب جميع الاستدعاءات إلى واجهة برمجة تطبيقات حماية ورقة العمل رمز وصول OAuth 2.0 صالح. أدرج الرمز في رأس Authorization:
Authorization: Bearer {access_token}
يجب الحصول على الرمز من نقطة نهاية المصادقة في Aspose Cloud، ويجب أن يتضمّن النطاق (Cells).
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تطبيق الحماية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صحيح (Bad Request) | معطيات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصرّح (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة برمجة تطبيقات حماية ورقة العمل؟
- تأمين البيانات المالية الحساسة – حماية ملفات Excel التي تحتوي على ميزانيات أو فواتير أو بيانات الرواتب باستخدام كلمتي مرور (لفتح وتعديل) لمنع الوصول غير المصرّح به أو التعديلات غير المسموح بها.
- مشاركة التقارير السرية بأمان – ضمان قدرة المستلمين المصرّح بهم فقط على عرض التقارير أو تعديلها عند توزيع التقارير التجارية أو التقارير الخاصة بالتدقيق أو الامتثال داخليًا أو خارجيًا.
- أتمتة أمن المستندات في سير العمل – دمج واجهة برمجة التطبيقات في الأنظمة المؤسسية (مثل أنظمة ERP وCRM) لحماية كلمات المرور تلقائيًا في أوراق العمل التي يتم إنشاؤها قبل حفظها أو إرسالها عبر البريد الإلكتروني.
- فرض الوصول للقراءة فقط – السماح للمستخدمين بفتح التقارير للعرض مع تقييد التعديلات باستخدام كلمة مرور مميزة للتعديل — مثالية للقوالب أو مجموعات البيانات النهائية.
- الامتثال للمتطلبات التنظيمية – المساعدة في الامتثال لمتطلبات GDPR أو HIPAA أو SOX من خلال تشفير بيانات أوراق العمل الحساسة عند التخزين وعند النقل عبر أتمتة الحماية.
لماذا يجب استخدام واجهة برمجة تطبيقات حماية ورقة العمل؟
- سهولة الاستخدام للمطورين – توفر Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، ما يُسهّل التطور السريع ويأتي مع وثائق شاملة. مقارنةً ببناء حلول مخصصة، هذا يقلل بشكل كبير من جهد التطوير.
- تقليل الحاجة إلى الموظفين – أتمتة دمج المستندات وأمنها، مما يقلل الحاجة إلى موظفين مخصصين.
- دفع مقابل الاستخدام فقط – لا استثمار أولي؛ تدفع فقط مقابل الاستدعاءات الفعلية لواجهة برمجة التطبيقات.
- لا تكاليف صيانة – لا خوادم للصيانة، ولا تحديثات برمجيات، ولا مخاوف تتعلق بالتوافق.
- الحفاظ على تنسيقات Excel الأصلية بالكامل أثناء تطبيق حماية بكلمة المرور، مما يضمن أن كتاب العمل المحمي يظهر تمامًا كما هو في الملف الأصلي.
كيفية استخدام واجهة برمجة تطبيقات حماية ورقة العمل باستخدام SDKs
مواصفات OpenAPI
توفر مواصفات واجهة برمجة تطبيقات حماية ورقة العمل واجهة برمجة برمجية عامة قابلة للوصول لتسهيل التفاعل المباشر عبر REST من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب بسهولة. يوضح المثال التالي كيفية إجراء استدعاءات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أفضل طريقة لتسريع التطوير. تتعامل SDK مع التفاصيل الأساسية، ما يسمح لك بتنفيذ وظيفة حماية ورقة العمل بحد أدنى من الكود. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الرمز التالية كيفية التفاعل مع خدمات Aspose.Cells عبر الويب باستخدام مكتبات SDK مختلفة: