الحصول على جميع الروابط التشعبية – وثائق Aspose.Cells Cloud REST API

تسترجع هذه الواجهة جميع الروابط التشعبية من ورقة عمل محددة في ملف Excel.

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

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

واجهة REST API

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

معلمات الطلب

اسم المعلمة	النوع	الموقع	مطلوبة	القيمة الافتراضية	الوصف
name	string	path	نعم	–	اسم ملف Excel.
sheetName	string	path	نعم	–	اسم ورقة العمل.
folder	string	query	لا	–	المجلد الذي يحتوي على الملف.
storageName	string	query	لا	–	اسم خدمة التخزين المراد استخدامها.

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

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

Request

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

Response

{
  "Hyperlinks": {
    "Count": 4,
    "HyperlinkList": [
      {
        "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": null
  },
  "Code": 200,
  "Status": "OK"
}

تحتوي استجابة JSON على كائن Hyperlinks.

Count – العدد الإجمالي للروابط التشعبية في ورقة العمل.
HyperlinkList – مصفوفة تحتوي كل عنصر فيها على كائن link. تحتوي الخاصية Href على عنوان الرابط التشعبي، بينما توفر الخاصيتان Rel و Title و Type معلومات وصفية إضافية (غالبًا تكون قيمتها null للروابط البسيطة).

استجابات الخطأ

كود HTTP	السبب	مثال على جسم الاستجابة
400	طلب غير صالح – معلمات مفقودة أو غير صالحة.	`{ "Code":"400", "Message":"Invalid parameter value." }`
401	غير مصادق – رمز JWT مفقود أو غير صالح.	`{ "Code":"401", "Message":"Access token is missing or invalid." }`
404	غير موجود – ملف Excel أو ورقة العمل غير موجودة.	`{ "Code":"404", "Message":"File not found." }`
500	خطأ داخلي في الخادم – فشل غير متوقع في الخادم.	`{ "Code":"500", "Message":"An unexpected error occurred." }`

عائلة حزم SDK للحوسبة السحابية

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

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

إضافة رابط تشعبي إلى ورقة عمل