إدارة ملفات إكسل عبر السحابة – التحقق من وجود المخزن
تُستخدم واجهة برمجة التطبيقات storageExists للتحقق مما إذا كان المخزن المحدّد موجودًا في خدمة Aspose.Cells Cloud. تُعتبر هذه الوظيفة ضرورية لضمان سير العمليات المعتمدة على المخزن دون أخطاء.
الملخص – تتيح نقطة النهاية storageExists تأكيد ما إذا كانت حاوية التخزين المحدّدة متاحة في Aspose.Cells Cloud. يُنصح باستخدامها قبل تنفيذ العمليات المرتبطة بالملفات لتفادي الأخطاء أثناء التشغيل.
التحقق من وجود المخزن (storageExists)
واجهة برمجة التطبيقات عبر الويب
GET https://api.aspose.cloud/v4.0/cells/storage/{storageName}/exist
الأمان والمصادقة
تُقدّم واجهات برمجة تطبيقات Aspose.Cells Cloud بشكل آمن وتتطلب المصادقة عبر رمز JWT.
متغيّرات الطلب
| اسم المتغيّر | النوع | الموقع | الوصف |
|---|---|---|---|
| storageName | String | Path | اسم المخزن الذي سيتم التحقق من وجوده. |
الاستجابة
{
"Name": "StorageExist",
"Description": ["تُشير إلى ما إذا كان المخزن المحدّد موجودًا أم لا."],
"Type": "Class",
"IsAbstract": false,
"Properties": [
{
"Name": "Exists",
"Description": [
"تُشير إلى ما إذا كان المخزن موجودًا.",
"ترجع هذه الخاصية القيمة true إذا كان المخزن موجودًا؛ وإلا ترجع false."
],
"Nullable": true,
"ReadOnly": false,
"IsInherit": false,
"DataType": {
"Identifier": "Boolean",
"Name": "boolean"
}
}
]
}
رموز حالات HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح (OK) | تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | غياب أو خطأ في المتغيّرات (مثل نوع ملف غير مدعوم). |
| 401 | غير مفوّض (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة برمجة التطبيقات الخاصة بالتحقق من وجود المخزن باستخدام SDKs؟
مواصفات OpenAPI
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول بشكل عام، مما يسمح للمطورين بالتفاعل بسلاسة مع واجهة REST API مباشرةً من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب بسهولة. يوضح المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو الطريقة الأكثر كفاءة لتسريع عملية التطوير. فتُجرّد SDKs المطورين من تفاصيل التنفيذ منخفضة المستوى، مما يمكّنهم من التركيز على مهام مشاريعهم. للاطّلاع على قائمة شاملة بـ SDKs المتاحة الخاصة بـ Aspose.Cells Cloud، يُرجى زيارة مستودع GitHub.
تُظهر أمثلة الكود التالية كيفية إجراء مكالمات API لخدمات الويب Aspose.Cells باستخدام SDKs مختلفة: