تقوم نقطة النهاية ConvertSpreadsheetToCsv بقراءة ملف جدول البيانات المرفوع من محرك محلي، وتُنفّذ عملية التحويل بالكامل على خوادم Aspose.Cells Cloud، ثم تُعيد ملف CSV الناتج كدفق ثنائي. وتُلغي هذه العملية المُبنية أصلاً على الحوسبة السحابية الحاجة إلى رفع ملف المصدر إلى التخزين السحابي، وتقلّل من تكاليف التخزين، وتبسّط سير العمل للمطورين الذين يحتاجون إلى تحويلات سريعة من جدول بيانات إلى CSV. وتعتمد التنسيقات المدعومة على المكتبات الأساسية، ويجب توفر أذونات مناسبة لقراءة ملف المصدر. ويتم إعادة الأخطاء مثل الملفات المفقودة أو الطلبات غير الصالحة أو فشل التحويل باستخدام رموز حالات HTTP القياسية.
واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV
PUT https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/csv
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.
مُعاملات الطلب:
| اسم المُعامل | النوع | الموقع | الإلزام | الوصف |
|---|---|---|---|---|
| Spreadsheet | ملف | FormData | إلزامي | ملف جدول البيانات المراد تحويله. يدعم التنسيقات الشائعة مثل .xls و.xlsx و.xlsm. يجب تقديمه كmultipart/form‑data. مثال: myWorkbook.xlsx. |
| outPath | سلسلة نصية | استعلام | اختياري | مسار مجلد الوجهة حيث سيتم حفظ ملف CSV المحول. إذا حُذِف، يُعاد ملف CSV مباشرةً في جسم الاستجابة. مثال: /output/reports/. |
| outStorageName | سلسلة نصية | استعلام | اختياري | اسم خدمة تخزين سحابي حيث سيتم حفظ ملف الإخراج. عند عدم تزويده، تُستخدم وحدة التخزين الافتراضية المُعدّة لحساب Aspose.Cells. |
| fontsLocation | سلسلة نصية | استعلام | اختياري | مسار مجلد يحتوي على خطوط مخصصة مطلوبة من قبل جدول البيانات. يُمكّن من العرض الصحيح للخلايا التي تستخدم خطوطًا غير قياسية. |
| region | سلسلة نصية | استعلام | اختياري | إعداد منطقة/لغة جدول البيانات (مثل en-US أو fr-FR). يؤثّر على تنسيق الأرقام وتحليل التواريخ والسلوك الخاص بالمنطقة المحلية. |
| password | سلسلة نصية | استعلام | اختياري | كلمة المرور المستخدمة لفتح جداول البيانات المحمية بكلمة مرور. إذا كان الملف مشفرًا وحُذِفت كلمة المرور أو كانت غير صحيحة، تُعاد رسالة خطأ 400/401. |
الاستجابة
في حال النجاح، تُعيد واجهة برمجة التطبيقات HTTP 200 (أو 202 للمعالجة غير المتزامنة) مع الرأس Content-Type: application/octet-stream. ويحتوي جسم الاستجابة على ملف CSV المُولّد كدفق ثنائي.
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالات HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تطبيق المرشّح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | مُعاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصادَق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حملة البيانات كبيرة جدًا (Payload Too Large) | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV؟
- تصدير البيانات لأنظمة إعداد التقارير – توليد مقتطفات CSV من تقارير مبنية على Excel لتزويد أدوات الذكاء التجاري أو مستودعات البيانات دون الحاجة إلى معالجة يدوية للملفات.
- المعالجة الدفعية الآلية – تحويل عدد كبير من جداول البيانات المخزّنة محليًا إلى CSV في مهمة جانب خادم، ثم تدفق النتائج مباشرةً إلى الخدمات اللاحقة.
- تطبيقات الويب مع رفع الملفات – السماح للمستخدمين النهائيين برفع ملف Excel واستلام إصدار CSV فورًا لمزيد من التحليل أو الاستيراد إلى منصات أخرى.
- دمج الأنظمة القديمة – ترجمة تنسيقات جداول البيانات القديمة إلى CSV لأنظمة تقبل فقط الملفات النصية المفصولة بفواصل.
لماذا استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV؟
- بنية بدون رفع للتخزين – لا حاجة لتخزين ملف المصدر في التخزين السحابي؛ يتم التحويل مباشرةً من الدفق المرفوع، مما يوفر الوقت وتكاليف التخزين.
- معالجة سحابية عالية الأداء – تستفيد من محرك التحويل المحسّن الخاص بـ Aspose.Cells على خوادم سحابية قابلة للتوسّع، وتُنتج مخرجات CSV سريعة حتى لملفات العمل الكبيرة.
- دمج بسيط – طلب PUT واحد مع مُعاملات استعلام اختيارية؛ تُعيد CSV كدفق ثنائي جاهز للتنزيل، مما يلغي خطوات المعالجة اللاحقة.
- دعم كامل للميزات – يتعامل مع الملفات المحمية بكلمة مرور، والخطوط المخصصة، والإعدادات الخاصة بالمنطقة المحلية، مما يضمن تحويلًا دقيقًا لجداول البيانات المعقدة.
كيفية استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV مع مكتبات SDK
مواصفات واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV
توفر مواصفات واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV واجهة برمجة برمجية يمكن الوصول إليها بشكل عام لتنفيذ تفاعلات REST مباشرةً من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. ويُظهر المثال التالي كيفية إجراء مكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة للتطوير، حيث يخفّي التفاصيل من المستوى المنخفض، ويتيح لك العمل مع جداول البيانات باستخدام كود موجز. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud. وتُظهر أمثلة الكود التالية كيفية التفاعل مع خدمات Aspose.Cells باستخدام مكتبات SDK المختلفة: