تحويل ملف Excel إلى JSON باستخدام واجهة Aspose.Cells Cloud API – دليل سريع
واجهة برمجة التطبيقات REST
تقوم هذه واجهة برمجة التطبيقات REST بتحويل ملف جدول بيانات إلى ملف بصيغة JSON.
POST https://api.aspose.cloud/v3.0/cells/convert/json
الأمان والمصادقة
تُعد واجهات برمجة التطبيقات السحابية لـ Aspose.Cells آمنة وتشترط المصادقة القائمة على رمز JWT.
الطلب
معلمات الاستعلام
| اسم المعلمة | النوع | الوصف |
|---|---|---|
password |
string | كلمة المرور المطلوبة لفتح ملف Excel (اختيارية). |
storageName |
string | اسم وحدة التخزين التي يوجد فيها الملف (اختيارية). |
checkExcelRestriction |
bool | يُطبّق قيودًا محددة بـ Excel عند تعديل الخلايا (اختياري). |
معلمة جسم الطلب
| اسم المعلمة | النوع | الوصف |
|---|---|---|
datafile |
file | ملف Excel المراد رفعه. يجب إرساله كجزء أول في طلب بصيغة multipart/form-data. |
مثال على استدعاء cURL
curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "accept: application/json" \
-H "Content-Type: multipart/form-data" \
-F "File=@myWorkbook.xlsx"
الاستجابة
تُعيد الخدمة كائن FileInfo. تُوضّح الحقول الأساسية أدناه:
| الحقل | النوع | الوصف |
|---|---|---|
Filename |
string | اسم ملف JSON الذي تم إنشاؤه (مثل myWorkbook.json). |
FileSize |
integer | حجم الملف الذي تم إنشاؤه بالبايتات. |
FileContent |
string | محتوى ملف JSON مشفرًا بنظام Base64. فك التشفير لاسترجاع محتوى JSON الفعلي. |
مثال على استجابة
{
"Filename": "myWorkbook.json",
"FileSize": 8423,
"FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH ... (سلسلة base64) ..."
}
معالجة الأخطاء
إذا فشل الطلب، تُعيد واجهة برمجة التطبيقات كائن خطأ بالهيكل التالي:
| الحقل | النوع | الوصف |
|---|---|---|
Code |
string | معرّف خطأ قابل للقراءة بواسطة الآلة. |
Message |
string | وصف قابل للقراءة بواسطة الإنسان للخطأ. |
رموز الحالة HTTP الشائعة:
- 400 – طلب غير صالح (مثل: ملف مفقود أو معلمات غير صحيحة).
- 401 – غير مُصادَق (رمز وصول غير صالح أو مفقود).
- 500 – خطأ داخلي في الخادم.
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تمت تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معلمات مفقودة أو غير صالحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مُصادَق | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostConvertWorkbookToJson API باستخدام SDKs
مواصفات واجهة PostConvertWorkbookToJson API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول بشكل عام وتسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يُظهر المثال التالي كيفية إجراء استدعاءات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. تتعامل SDK مع التفاصيل منخفضة المستوى لتمكينك من التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء استدعاءات لخدمات الويب الخاصة بـ Aspose.Cells باستخدام مكتبات SDK مختلفة:
واجهات برمجة تطبيقات أخرى تُنفّذ وظائف مماثلة
- POST /cells/{name}/saveAs – تحفظ ملف Excel كملف HTML مع إعدادات إضافية وتخزن النتيجة في وحدة التخزين المحددة.
- PUT /cells/convert – تحول ملف Excel إلى ملف HTML مع إعدادات إضافية وترد بالنتيجة في الاستجابة.
- GET /cells/{name} – تسترجع ملف Excel؛ يمكن استخدامها مع معلمات استعلام للحصول على الملف بصيغة HTML.