واجهة برمجة تطبيقات تنزيل الملف في Aspose.Cells Cloud – واجهة لتنزيل الملفات بسرعة في السحابة
تتيح لك واجهة برمجة التطبيقات DownloadFile استرجاع الملفات المخزنة في تخزين Aspose.Cells Cloud. تُعد واجهة برمجة تطبيقات تنزيل الملف ضرورية للوصول مباشرةً إلى جداول Excel وملفات PDF وCSV وتنسيقات أخرى مدعومة من السحابة.
واجهة برمجة تطبيقات Excel: تنزيل الملف
واجهة برمجة التطبيقات عبر الويب
GET https://api.aspose.cloud/v4.0/cells/storage/file/{path}
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
-H "Authorization: Bearer {access_token}"
معلمات الطلب لواجهة برمجة التطبيقات DownloadFile
| اسم المعلمة | النوع | الموقع (مسار / استعلام) | الوصف |
|---|---|---|---|
| path | سلسلة نصية | المسار | المسار الظاهري للملف الذي ترغب في تنزيله. |
| storageName | سلسلة نصية | استعلام | اسم التخزين الذي سيتم استرجاع الملف منه. |
| versionId | سلسلة نصية | استعلام | معرّف الإصدار للملف المراد تنزيله، إن وُجد. |
الاستجابة
تعيد واجهة برمجة التطبيقات تدفق ملف ثنائي. يتوافق رأس Content-Type مع تنسيق الملف (مثلاً، application/vnd.openxmlformats-officedocument.spreadsheetml.sheet لملفات XLSX). ولا يتم إرجاع أي حمولة (payload) بصيغة JSON.
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق المرشح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معلمات ناقصة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُauthorized (Unauthorized) | رمز JWT غير صالح أو ناقص. |
| 413 | حملة كبيرة جدًا (Payload Too Large) | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
مواصفات OpenAPI
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام، وتسمح لك بإجراء تفاعلات REST مباشرةً من خلال متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يُظهر المثال التالي كيفية إجراء المكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs لـ Aspose.Cells Cloud
يُعد استخدام SDKs أفضل طريقة لتسريع عملية التطوير. فتتولى SDKs إدارة التفاصيل من المستوى المنخفض، مما يتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء المكالمات إلى خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: