واجهة برمجة تطبيقات التحقق من وجود الكائن – التحقق من وجود ملف أو مجلد في Aspose.Cells Cloud
تتيح واجهة برمجة تطبيقات التحقق من وجود الكائن للمطورين تحديد ما إذا كان ملف أو مجلد معيّن موجودًا في مساحة التخزين السحابية لـ Aspose.Cells. وتُعيد قيمة منطقية بسيطة تشير إلى الوجود، وما إذا كانت المسار تشير إلى مجلد.
واجهة برمجة تطبيقات Excel: التحقق من وجود الكائن
واجهة برمجة التطبيقات عبر الويب
GET https://api.aspose.cloud/v5.0/cells/storage/exist/{path}
{path} هو المسار الكامل إلى الملف أو المجلد داخل التخزين.
الأمان والمصادقة
تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud أمانًا عاليًا وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | مطلوب | الوصف |
|---|---|---|---|---|
path |
string | Path | نعم | المسار الكامل إلى الملف أو المجلد. |
storageName |
string | Query | لا | اسم التخزين؛ يُستخدم التخزين الأساسي افتراضيًا في حال حذفه. |
versionId |
string | Query | لا | معرّف إصدار معيّن للملف (في حال تفعيل إصدارات الملفات). |
رموز حالة HTTP
| رمز HTTP | حالة HTTP | الوصف |
|---|---|---|
| 200 | OK (نجاح) | تم استدعاء واجهة برمجة التطبيقات بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب غير صالح) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مُصرّح له) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حمولة كبيرة جدًا) | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | خطأ غير متوقع في الخادم. |
الاستجابة
يعيد الاتصال الناجح حُمولة JSON تحتوي على خاصيتين:
{
"Exists": true,
"IsFolder": false
}
- Exists –
trueفي حال وجود الملف أو المجلد؛ خلاف ذلكfalse. - IsFolder –
trueفي حال كانت المسار تشير إلى مجلد؛falseفي حال كانت تشير إلى ملف.
مواصفات OpenAPI
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة للعامة، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يوضح المثال التالي كيفية إجراء مكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير، إذ تعتني SDK بمعالجة التفاصيل منخفضة المستوى، وتتيح لك التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الرمز التالية كيفية إجراء مكالمات إلى خدمات الويب الخاصة بـ Aspose.Cells باستخدام SDKs مختلفة. في حال فشل تحميل Gist، يُقدَّم مثال ثابت تحت كل علامة تبويب.