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

تسترجع هذه الواجهة البرمجية (REST API) الرابط التشعبي في ورقة العمل باستخدام واجهة Aspose.Cells Get Hyperlink API.

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

واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.
قبل استدعاء نقطة النهاية، احصل على رمز وصول JWT باستخدام مُعرِّف العميل (Client ID) وسر العميل (Client Secret)، ثم ضعه في رأس الطلب Authorization: Bearer <jwt token>.

واجهة برمجة التطبيقات (REST API)

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

معلمات الطلب

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

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

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

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

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

Request

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

Response

{
  "Hyperlink": {
    "Address": "https://docs.aspose.cloud/display/cellscloud/Get+Hyperlink+from+Excel+Worksheet",
    "Area": {
      "EndColumn": 0,
      "EndRow": 1,
      "StartColumn": 0,
      "StartRow": 1
    },
    "ScreenTip": null,
    "TextToDisplay": "https://docs.aspose.cloud/display/cellscloud/Get+Hyperlink+from+Excel+Worksheet",
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/hyperlinks/1",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

عائلة SDKs السحابية

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

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

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