تحويل ورقة عمل إلى جدول HTML – واجهة برمجة تطبيقات Aspose.Cells Cloud
تحويل ورقة العمل إلى جدول HTML ضمن خدمات ويب Aspose.Cells Cloud
تقوم هذه العملية بقراءة ملف جدول محاسبي من نظام الملفات المحلي، وتحويل ورقة العمل المحددة فيه إلى جدول HTML، ثم إعادة النتيجة المحولة ك поток ملف (file stream). ويتم إجراء التحويل بالكامل على خادم السحابة، لذا لا يتطلب تحميلًا مبدئيًّا إلى مساحة التخزين السحابية. كما يدعم إعدادات التوطين (Locale) الاختيارية وملفات العمل المحمية بكلمة مرور.
نقطة نهاية واجهة برمجة التطبيقات على الويب
PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/html-table
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة قائمة على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | المسار / سلسلة الاستعلام / جسم HTTP | الوصف |
|---|---|---|---|
| Spreadsheet | ملف | FormData | رفع ملف الجدول المحاسبي. |
| worksheet | نص | استعلام | اسم ورقة العمل داخل الجدول المحاسبي. (مطلوبة) |
| region | نص | استعلام | إعدادات المنطقة/اللغة للجدول المحاسبي (مثل en-US، fr-FR). تؤثر على تنسيق الأرقام، وتفسير التواريخ، وسلوك الإعدادات المحلية. |
| password | نص | استعلام | كلمة المرور المطلوبة لفتح ملف الجدول المحاسبي. |
معامل جسم الطلب
| اسم المعامل | النوع | الوصف |
|---|---|---|
| لا يوجد | لا يوجد | لا يُطلب وجود جسم JSON؛ يُرسل الملف على شكل multipart/form-data. |
الاستجابة
{
"File": " поток ثنائي للجدول HTML الناتج"
}
رموز حالة الاستجابة
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح | تم تحويل ورقة العمل إلى جدول HTML بنجاح، وتم إعادته ك поток ملف. |
| 400 | طلب غير صالح | عنوان URL غير صالح أو معاملات مطلوبة مفقودة. |
| 401 | غير مُصادَق عليه | فشلت المصادقة أو لم تُقدَّم أي بيانات اعتماد. |
| 404 | غير موجود | الملف المصدر غير قابل للوصول. |
| 500 | خطأ داخلي في الخادم | واجه الجدول المحاسبي حالة شاذة أثناء جلب بيانات التحويل. |
| 413 | حجم الحمولة كبير جدًّا | تجاوز حجم الملف المرفوع الحد المسموح به. |
كيفية استخدام خدمة تحويل ورقة العمل إلى جدول HTML باستخدام مكتبات SDK
مواصفات تحويل ورقة العمل إلى جدول HTML
تُعرِّف مواصفات واجهة برمجة تطبيقات تحويل ورقة العمل إلى جدول HTML واجهة برمجة تطبيقات عامة قابلة للاستعمال، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
{< tabs tabTotal=“2” tabID=“1” tabName1=“Request” tabName2=“Response” >}
{< tab tabNum=“1” >}
# استخدام بروتوكول HTTPS لاتصال آمن
curl -v "https://api.aspose.cloud/v4.0/cells/convert/worksheet/html-table?worksheet={worksheet}®ion={region}&password={password}" \
-X PUT \
-H "Content-Type: multipart/form-data" \
-H "Accept: application/octet-stream" \
-H "Authorization: Bearer <jwt token>" \
-F "Spreadsheet=@sample.xlsx"
{< /tab >}
{< tab tabNum=“2” >}
{
"File": " поток ثنائي للجدول HTML الناتج"
}
{< /tab >}
{< /tabs >}
استخدام مكتبات Aspose.Cells Cloud SDK
يُعد استخدام مكتبات SDK أسرع طريقة لتسريع عملية التطوير. فهي تُجرّدك من التفاصيل التقنية الدقيقة، وتسمح لك بالتركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطّلاع على قائمة كاملة بمكتبات Aspose.Cells Cloud SDK.