الحصول على وصف الصف من ورقة عمل Excel – Aspose.Cells Cloud API

المتطلبات المسبقة:

احصل على رمز وصول JWT صالح وشّمله في الرأس Authorization: Bearer <jwt token>.
تأكّد من أن ملفّ المصنف مخزّن في مستودع Aspose Cloud، أو حدد مسار المجلّد الذي يوجد فيه.
استخدم إصدار API v3.0 كما هو مبيّن في عنوان URL للنهاية.

تُعيد هذه الواجهة البرمجية لـ REST استرجاع بيانات الصف باستخدام فهرسه في ورقة عمل Excel.

واجهة GetWorksheetRow البرمجية

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}

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

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

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

اسم المعلّمة	النوع	الموقع	الوصف
name	string	path	اسم ملف المصنف.
sheetName	string	path	اسم ورقة العمل داخل المصنف.
rowIndex	integer	path	الفهرس بصيغة الصفر-مبني للصف المراد استرجاعه.
folder	string	query	المجلّد الذي يحتوي على المصنف.
storageName	string	query	اسم المستودع الذي يوجد فيه المصنف.

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

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب بسهولة. يُظهر المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL. شمّل الرأس Authorization: Bearer <jwt token> لمصادقة الطلب.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/0" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Row": {
    "GroupLevel": 0,
    "Height": 13.5,
    "Index": 0,
    "IsBlank": false,
    "IsHeightMatched": true,
    "IsHidden": false,
    "Style": {
      "link": {
        "Href": "/style",
        "Rel": "self"
      }
    },
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/cells/rows/0",
      "Rel": "self"
    }
  },
  "Code": 200,
  "Status": "OK"
}

مخطط الاستجابة

الخاصية	النوع	الوصف
`GroupLevel`	integer	المستوى التفصيلي (المحوري) للصف (يُستخدم للتجميع).
`Height`	number	ارتفاع الصف بوحدات النقاط.
`Index`	integer	الفهرس بصيغة الصفر-مبني للصف المُعاد.
`IsBlank`	boolean	يشير إلى ما إذا كان الصف يحتوي على أي بيانات.
`IsHeightMatched`	boolean	`true` إذا كان ارتفاع الصف مطابقًا لارتفاع الصف الافتراضي.
`IsHidden`	boolean	`true` إذا كان الصف مخفيًّا.
`Style`	object	كائن يحتوي على معلومات النمط للصف.
`link`	object	مرجع رابط تشعبي إلى مورد الصف.
`Code`	integer	رمز حالة HTTP للاستجابة.
`Status`	string	وصف نصّي للحالة (مثل “OK”).

ملاحظات / معالجة الأخطاء: قد تُعيد الواجهة البرمجية رموز الحالة التالية لـ HTTP:

200 – نجاح; تُعاد بيانات الصف.
401 – غير مصادق; رمز JWT مفقود أو غير صالح.
404 – غير موجود; المصنف أو ورقة العمل أو الصف المحدّد غير موجود.
500 – خطأ داخلي في الخادم; حدثت حالة غير متوقّعة.

الكود	الوصف	التصحيح
200	نجاح – تُعاد بيانات الصف.	–
401	غير مصادق – رمز JWT مفقود أو غير صالح.	قدم رمز JWT صالحًا.
404	غير موجود – المصنف أو ورقة العمل أو الصف مفقود.	تأكّد من أسماء الملفات وفهرس الصف.
500	خطأ داخلي في الخادم – حالة غير متوقّعة.	اتّصل بدعم Aspose.

للحصول على قائمة كاملة برموز الأخطاء، راجع مستند رموز الأخطاء في Aspose.Cells Cloud.

عائلة SDK للسحابة

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

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