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

تسترجع هذه الواجهة REST معلومات الصفوف من ورقة عمل Excel.

المتطلبات الأساسية
لاستدعاء هذه النقطة النهائية (endpoint)، يجب توفير رمز JWT صالح في رأس التفويض Authorization. ويجب الحصول على الرمز باستخدام تدفق المصادقة الخاص بـ Aspose.Cloud، ويجب أن يحتوي على النطاقات (scopes) المطلوبة لعمليات خدمة Cells. وتتبع هذه الواجهة مخطط الإصدار v3.0، وهي خاضعة لسياسات التقييد القياسية (rate-limit policies).

GetWorksheetRows API

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

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

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

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	string	path	اسم المصنف (الملف).
sheetName	string	path	اسم ورقة العمل.
folder	string	query	مجلد المصنف.
storageName	string	query	اسم وحدة التخزين.

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

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

Request

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

Response

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

أكواد الاستجابة

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

مجموعة أدوات SDK للسحابة

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

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

Request

curl -X GET "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" -H "accept: application/json"

Response

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

مجموعة أدوات SDK للسحابة

استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولى أدوات SDK معالجة التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مهام مشروعك. فيما يلي أمثلة على الأكواد المكتوبة بلغات برمجة مختلفة لاسترجاع صفوف ورقة العمل.