إضافة توقيع رقمي إلى كتاب عمل Excel – واجهة Aspose.Cells Cloud API
المتطلبات المسبقة:
قبل استدعاء هذه النقطة النهائية (endpoint)، تأكّد من توفر ما يلي:
- رمز وصول JWT صالح تم الحصول عليه عبر مصادقة Aspose Cloud.
- رفع كتاب العمل المستهدف إلى مساحة التخزين الخاصة بك على Aspose Cloud.
- وجود ملف التوقيع الرقمي بصيغة
.pfxأو.p12مع كلمة مرور هذا الملف.
تقوم هذه الواجهة البرمجية عبر REST بإضافة توقيع رقمي إلى كتاب عمل Excel.
PostDigitalSignature API
POST https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature
الأمان والمصادقة
تُستخدم واجهات Aspose.Cells Cloud APIs أمانًا وتتطلب مصادقة قائمة على رمز JWT.
مَعلمات الطلب
| اسم المَعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | <code>path</code> |
اسم كتاب العمل. |
| digitalsignaturefile | string | <code>query</code> |
المسار إلى ملف التوقيع الرقمي (.pfx أو .p12). |
| password | string | <code>query</code> |
كلمة المرور الخاصة بكتاب العمل، إن وُجدت. |
| folder | string | <code>query</code> |
المجلد الذي يُخزّن فيه كتاب العمل. |
| storageName | string | <code>query</code> |
اسم خدمة التخزين المراد استخدامها. |
ملاحظة: إذا احتوى اسم الملف على أحرف خاصة، فقم بترميزه باستخدام URL قبل إدراجه في سلسلة الاستعلام (query string).
معالجة الأخطاء
| حالة HTTP | المعنى |
|---|---|
| 200 | تم تطبيق التوقيع بنجاح. |
| 400 | طلب غير صالح – مَعلمات مفقودة أو غير صالحة. |
| 401 | غير مُصرّح – رمز OAuth غير صالح أو منتهي الصلاحية. |
| 403 | ممنوع – صلاحيات غير كافية أو تم رفض الوصول. |
| 500 | خطأ داخلي في الخادم – فشل غير متوقع. |
استجابات الأخطاء حسب حالة HTTPS
| حالة HTTP | الرمز | الوصف |
|---|---|---|
| 400 | BadRequest | مَعلمات مفقودة أو غير صالحة. |
| 401 | Unauthorized | رمز وصول غير صالح أو مفقود. |
| 404 | NotFound | كتاب العمل المحدد غير موجود في المجلد/مساحة التخزين المعطاة. |
| 500 | InternalServerError | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostDigitalSignature مع واجهات برمجة التطبيقات (SDKs)
مواصفات واجهة PostDigitalSignature API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL لاستدعاء خدمات Aspose.Cells عبر الويب. يُظهر المثال التالي طلبًا موجّهًا إلى الواجهة:
مخطط الاستجابة
تعيد الواجهة كائن JSON يحتوي على الحقول التالية:
| الحقل | النوع | الوصف |
|---|---|---|
Code |
int | رمز حالة مشابه لحالة HTTP يُشير إلى النتيجة. |
Status |
string | نص قصير يصف النتيجة (مثل OK). |
SignatureId |
string | مُعرّف التوقيع الرقمي المُطبّق (اختياري). |
Message |
string | معلومات إضافية أو تفاصيل الخطأ (اختياري). |
استخدام واجهات Aspose.Cells Cloud SDKs
استخدام واجهات برمجة التطبيقات (SDKs) يبسّط التكامل ويقلّل من الحاجة إلى كتابة كود متكرر. يُرجى زيارة مستودع GitHub للاطّلاع على القائمة الكاملة لواجهات برمجة التطبيقات (SDKs) الخاصة بـ Aspose.Cells Cloud.
توضّح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام واجهات برمجة التطبيقات المختلفة: