كيفية تحويل جدول بيانات محلي إلى JSON باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud
يحوّل الـ Endpoint ConvertSpreadsheetToJson جدول بيانات مخزّن على محرك أقراص محلي إلى ملف JSON بالكامل على خوادم خدمة Aspose.Cells Cloud. وبإرسال جدول البيانات كـ multipart/form-data، تُرجع الخدمة تدفق JSON جاهزًا للتنزيل أو المعالجة اللاحقة. ويُلغي هذا التحويل القائم على السحابة الحاجة إلى رفع الملف إلى التخزين مسبقًا، ويقلّل من تكاليف التخزين، ويبسّط سير العمل للتطبيقات التي تتطلب بيانات جداول البيانات بصيغة JSON لأغراض التحليل، أو التقارير، أو تبادل البيانات.
المتطلبات الأساسية: يجب أن تمتلك حسابًا في Aspose Cloud، ورمز وصول JWT صالحًا، وتم إعداد SDK أو مفتاح API لخدمة Aspose.Cells Cloud.
الخلفية: يُعد تحويل جداول البيانات إلى تنسيق JSON خطوة شائعة عند دمج بيانات Excel مع خدمات الويب، أو قواعد بيانات NoSQL، أو تطبيقات JavaScript من جانب العميل. وتوفّر واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON تحويلًا سريعًا من جانب الخادم دون الحاجة إلى تخزين الملف الأصلي.
واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON
PUT https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/json
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى المصادقة باستخدام رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | إلزامي/اختياري | الوصف |
|---|---|---|---|---|
| Spreadsheet | ملف (multipart/form-data) | FormData | إلزامي | ملف جدول البيانات المصدر (مثل: .xls، .xlsx، .xlsm). مثال: curl -F "Spreadsheet=@myfile.xlsx" |
| outPath | سلسلة نصية (String) | Query | اختياري | مسار المجلد الهدف في التخزين السحابي حيث سيتم حفظ ملف JSON المحول. إذا تُرك فارغًا، يُعاد JSON مباشرةً في تدفق الاستجابة. مثال: outPath=/output/. |
| outStorageName | سلسلة نصية (String) | Query | اختياري | اسم خدمة التخزين السحابي (مثل: Amazon S3، Azure Blob) حيث يجب كتابة ملف الإخراج. مطلوب فقط عند استخدام outPath مع تخزين غير افتراضي. |
| fontsLocation | سلسلة نصية (String) | Query | اختياري | مسار مجلد خطوط مخصص على الخادم. استخدم هذا الخيار عندما يشير جدول البيانات إلى خطوط غير متوفرة في المكتبة الافتراضية. |
| region | سلسلة نصية (String) | Query | اختياري | إعداد منطقة/لغة جدول البيانات (مثل: en-US، fr-FR). يؤثر على تنسيق الأرقام والتواريخ والعملات أثناء التحويل. |
| password | سلسلة نصية (String) | Query | اختياري | كلمة المرور لفتح جدول بيانات محمي بكلمة مرور. تجاهله للملفات غير المحمية. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صحيحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مُصادَق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON؟
- خطوط أنابيب نقل البيانات (Data migration pipelines) – تحويل تقارير Excel القديمة إلى تنسيق JSON لاستهلاكها في قواعد بيانات NoSQL الحديثة أو بحيرات البيانات.
- التطبيقات المحمولة أو الويب – تحويل جداول البيانات التي يُرفعها المستخدم بسرعة إلى تنسيق JSON لعرضها من جانب العميل دون تخزين الملف الأصلي في السحابة.
- توليد التقارير تلقائيًا – إنشاء حمولات JSON لخدمات التحليل اللاحقة (مثل: Power BI، Tableau) مباشرةً من مدخلات جداول البيانات.
- الوظائف بدون خادم (Serverless functions) – استخدام الواجهة داخل AWS Lambda أو Azure Functions لأداء عمليات تحويل فورية دون إدارة تخزين مؤقت.
لماذا يجب استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON؟
- التحويل القائم على السحابة يلغي الحاجة إلى رفع ملفات كبيرة إلى التخزين قبل المعالجة، مما يقلل من زمن الاستجابة وتكاليف التخزين.
- سير عمل مكوّن من طلب واحد: رفع جدول البيانات واستلام JSON في نفس استدعاء HTTP، مما يبسّط منطق الدمج.
- يدعم جداول البيانات المحمية بكلمة مرور والجداول المخصصة للمناطق، مما يضمن تمثيلًا دقيقًا للبيانات عبر المناطق المختلفة.
- قابل للتحجيم على بنية Aspose الأساسية – يتعامل مع كتب عمل كبيرة ومعادلات معقدة دون التأثير على موارد خادمك.
كيفية استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON باستخدام SDKs
مواصفات واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON
توفر مواصفات واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON واجهة برمجة تطبيقات قابلة للوصول بشكل عام لتنفيذ تفاعلات REST مباشرةً من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة للتطوير، حيث يُخفي التفاصيل من المستوى المنخفض ويجعلك قادرًا على تحويل جدول بيانات إلى JSON باستخدام بضع سطور من الكود.
يرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية التفاعل مع خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: