تقسيم ملف Excel إلى ملفات متعددة - وثائق Aspose.Cells Cloud

تقوم واجهة Aspose.Cells Cloud REST API بتقسيم ملفات عمل Excel ذات أوراق متعددة إلى ملفات منفصلة.

المتطلبات الأساسية
قبل استدعاء الواجهة البرمجية، يجب عليك الحصول على رمز JWT صالح وتشمله في رأس Authorization لكل طلب. راجع دليل المصادقة للحصول على التفاصيل.

واجهة PostSplit API

POST https://api.aspose.cloud/v3.0/cells/split

الأمان والمصادقة

تُعد واجهات برمجة التطبيقات Aspose.Cells Cloud آمنة وتشترط مصادقة تعتمد على رمز JWT.

معاملات الطلب

اسم المعامل النوع الموقع الوصف
file ملف formData ملف عمل Excel المراد تحميله.
format نص query تنسيق الإخراج المرغوب (مثل pdf أو csv أو json).
password نص query كلمة المرور لملف العمل المشفر (اختياري).
from عدد صحيح query فهرس الورقة الأولى التي سيتم تضمينها (العد يبدأ من 1).
to عدد صحيح query فهرس الورقة الأخيرة التي سيتم تضمينها (بما في ذلك).

الاستجابة

{
    "Status" : "OK",
    "Code" : 200,
    "Files": [
        {
            "Filename" : "[اسم الملف1]",
            "Filesize" : [حجم الملف],
            "FileContent" : "[Base64String]"
        },
        {
            "Filename" : "[اسم الملف2]",
            "Filesize" : [حجم الملف],
            "FileContent" : "[Base64String]"
        },
        {
            "Filename" : "[اسم الملف3]",
            "Filesize" : [حجم الملف],
            "FileContent" : "[Base64String]"
        }
    ]
}

رموز حالات HTTP

الرمز المعنى الوصف
200 OK (تمت العملية بنجاح) تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400 Bad Request (طلب غير صالح) معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401 Unauthorized (غير مخوّل) رمز JWT غير صالح أو مفقود.
413 Payload Too Large (حمولة كبيرة جداً) تجاوز الملف المرفوع الحد الأقصى للحجم.
500 Internal Server Error (خطأ داخلي في الخادم) حدث خطأ غير متوقع في جانب الخادم.

كيفية استخدام واجهة PostSplit API باستخدام SDKs

مواصفات واجهة PostSplit API

تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.

رموز حالات HTTP

الرمز المعنى الوصف
200 OK (تمت العملية بنجاح) تم تقسيم ملف العمل بنجاح وتحتوي الاستجابة على قائمة الملفات.
400 Bad Request (طلب غير صالح) معاملات مفقودة أو غير صالحة (مثل تنسيق غير مدعوم).
401 Unauthorized (غير مخوّل) رمز JWT غير صالح أو مفقود.
500 Internal Server Error (خطأ داخلي في الخادم) حدث خطأ غير متوقع في جانب الخادم.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL.

استخدام SDKs الخاصة بـ Aspose.Cells Cloud

استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولى SDK معالجة التفاصيل من المستوى المنخفض وتركز أنت على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية إجراء المكالمات إلى خدمات ويب Aspose.Cells باستخدام SDKs مختلفة:

دمج مصنف Excel داخل مصنف آخر