احصل على محور الفئات للرسم البياني – وثائق API لـ Aspose.Cells Cloud

تسترجع هذه الواجهة محور الفئات لرسم بياني.
لاستدعاء هذه الواجهة، يجب أن تقدّم رمز وصول JWT OAuth 2.0 صالحًا، ويجب أن يكون ملف المصنف مخزّنًا في مساحة التخزين السحابية لـ Aspose Cloud.

المتطلبات الأساسية
قبل استخدام هذه الواجهة، تأكّد من وجود ما يلي:

رمز وصول JWT OAuth 2.0 تم الحصول عليه وهو ساري المفعول لخدمات Aspose Cloud.
ملف المصنف مُحمّل في مساحة التخزين السحابية لـ Aspose Cloud (الافتراضية أو مجلد محدّد).
تستخدم إصدار الواجهة v3.0 كما هو مبيّن في عنوان URL للطلب.
لدى التطبيق الذي يُجري الطلب صلاحية قراءة ملف المصنف والوصول إلى أوراق عمل المصنف.

واجهة GetChartCategoryAxis API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/categoryaxis

الخلفية – إن إزالة جميع الرسوم البيانية من ورقة العمل مفيد عندما تحتاج إلى إعادة ضبط التخطيط البصري لورقة العمل، أو استبدال التصورات القديمة، أو إعداد المصنف لإعادة الاستخدام دون الاحتفاظ ببيانات الرسوم البيانية السابقة.

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

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

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

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف المصنف.
sheetName	string	path	اسم ورقة العمل التي تحتوي على الرسم البياني.
chartIndex	integer	path	المؤشر الصفري (zero-based) للرسم البياني المطلوب محوره.
folder	string	query	مسار المجلد في مساحة التخزين حيث يقع المصنف.
storageName	string	query	اسم خدمة التخزين (إذا لم يكن الاسم الافتراضي).

الاستجابة

{
  "Code": 200,
  "Status": "OK",
  "CategoryAxis": {
    "AxisBetweenCategories": true,
    "AxisLine": {
      "IsVisible": true,
      "Weight": 1.0
    },
    "MajorTickMark": "Cross",
    "MinorTickMark": "None",
    "Title": {
      "Text": "Category Axis",
      "IsVisible": true
    },
    "Labels": {
      "IsAutoRotation": false,
      "RotationAngle": 0,
      "IsVisible": true
    }
  }
}

رموز حالة HTTP

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

كيفية استخدام واجهة GetChartCategoryAxis API باستخدام مكتبات SDK

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

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

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/categoryaxis" \
-X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Code": 200,
  "Status": "OK",
  "CategoryAxis": {
    "AxisBetweenCategories": true,
    "AxisLine": {
      "IsVisible": true,
      "Weight": 1.0
    },
    "MajorTickMark": "Cross",
    "MinorTickMark": "None",
    "Title": {
      "Text": "Category Axis",
      "IsVisible": true
    },
    "Labels": {
      "IsAutoRotation": false,
      "RotationAngle": 0,
      "IsVisible": true
    }
  }
}

استخدام مكتبات Aspose.Cells Cloud SDK

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

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

واجهة برمجة تطبيقات Aspose.Cells Cloud – تحديث محور القيم في المخطط (POST /valueaxis) احصل على تنسيق ملء منطقة المخطط – واجهة برمجة تطبيقات Aspose.Cells Cloud (الإصدار 3.0)