FlipData – Aspose.Cells Cloud
FlipData في خدمات ويب Aspose.Cells Cloud
تُعيد هذه الواجهة البرمجية تغيير اتجاه مصفوفة البيانات المعطاة. فعلى سبيل المثال، سيتحول النطاق 3×2 (3 صفوف وعمودان) إلى نطاق 2×3 (صفان و3 أعمدة) في المخرجات. وتُستخدم هذه الميزة عادةً لإعادة هيكلة البيانات لتلبية متطلبات الإدخال الخاصة بمختلف المخططات أو التقارير أو نماذج البيانات.
نقطة نهاية الواجهة البرمجية للويب
PUT https://api.aspose.cloud/v4.0/cells/flip
الأمان والمصادقة
تعمل واجهات برمجة تطبيقات Aspose.Cells Cloud بشكل آمن وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | المسار / سلسلة الاستعلام / جسم HTTP | الوصف |
|---|---|---|---|
| Spreadsheet | ملف | FormData | رفع ملف جدول البيانات. |
| worksheet | نص | استعلام | اسم ورقة العمل. |
| cellArea | نص | استعلام | نطاق بيانات مُحدّد. |
| Horizontal | منطقي | استعلام | قلب أفقي/رأسي. القيمة الافتراضية: true |
| outPath | نص | استعلام | (اختياري) مسار المجلد حيث يتم حفظ ملف العمل. القيمة الافتراضية: null. |
| outStorageName | نص | استعلام | اسم وحدة التخزين الخاصة بالملف الناتج. |
| region | نص | استعلام | إعدادات منطقة/لغة جدول البيانات (مثل en-US, fr-FR). تؤثر على تنسيق الأرقام، وتحليل التواريخ، والسلوك الخاص بالمنطقة المحلية. |
| password | نص | استعلام | كلمة المرور لفتح ملف جدول البيانات. |
معامل جسم الطلب
| اسم المعامل | النوع | الوصف |
|---|---|---|
| لا يوجد | غير مُعرّف | لا يُطلب أي جسم JSON إضافي؛ يتم إرسال الملف كـ multipart/form-data. |
الاستجابة
{
"File": "<تدفق ثنائي لملف العمل المحوّل>"
}
رموز حالة الاستجابة
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | اكتملت العملية بنجاح وعُاد ملف جدول البيانات المحوّل. |
| 400 | طلب غير صالح | معامل مطلوب مفقود أو غير صالح أو أكثر. |
| 401 | غير مصرّح به | فشلت المصادقة – رمز JWT مفقود أو غير صالح. |
| 413 | حجم الحمولة كبير جدًا | تجاوز حجم الملف المرفوق الحد المسموح به. |
| 500 | خطأ داخلي في الخادم | حدث خطأ غير متوقع في الخادم. |
كيفية استخدام FlipData مع مكتبات SDK
مواصفات FlipData
تُعرّف مواصفات FlipData API واجهة برمجة تطبيقات متاحة للعامة وتسمح لك بإجراء عمليات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells Cloud. يوضح المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام مكتبات SDK الخاصة بـ Aspose Cells Cloud
استخدام مكتبة SDK هو أسرع طريقة لتسريع عملية التطوير. وتُجسّد مكتبة SDK التفاصيل من المستوى المنخفض، مما يتيح لك التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.