إضافة رابط تشعبي إلى ورقة عمل
تقوم هذه الواجهة البرمجية للواجهة (REST API) بإضافة رابط تشعبي إلى ورقة عمل Excel.
واجهة برمجة التطبيقات REST
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/hyperlinks
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم المستند. |
| sheetName | string | path | اسم ورقة العمل. |
| firstRow | integer | query | المؤشر المبدئي (من الصفر) للصف الأول في النطاق الذي سيُطبّق عليه الرابط التشعبي. |
| firstColumn | integer | query | المؤشر المبدئي (من الصفر) للعمود الأول في النطاق الذي سيُطبّق عليه الرابط التشعبي. |
| totalRows | integer | query | عدد الصفوف التي يغطيها نطاق الرابط التشعبي. |
| totalColumns | integer | query | عدد الأعمدة التي يغطيها نطاق الرابط التشعبي. |
| address | string | query | عنوان URL الهدف الذي يشير إليه الرابط التشعبي (مُشفّر بتنسيق URL). |
| folder | string | query | مجلد المستند. |
| storageName | string | query | اسم وحدة التخزين. |
يمكن أن يتضمّن الطلب أيضًا جسمًا JSON يحتوي على نفس الحقول (Address, FirstRow, FirstColumn, TotalRows, TotalColumns). يُفضّل تزويد الجسم عند تفضيل استخدام حمولة البيانات (payload) على معاملات سلسلة الاستعلام.
استجابات الأخطاء
| الكود 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 عبر الويب بسهولة. يُظهر المثال التالي كيفية إجراء استدعاءات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
في حال فشل الطلب، تُعيد الواجهة أكواد HTTP الأخطائية القياسية (مثل 400 Bad Request، 401 Unauthorized، 404 Not Found، 500 Internal Server Error)، مُرفقةً بحمولة JSON تحتوي على رسالة ورمز الخطأ.
عائلة SDK السحابية
يُعد استخدام SDK أسرع طريقة لتطوير التطبيقات. فتتولى SDK التعامل مع التفاصيل منخفضة المستوى، مما يمكّنك من التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر SDKs مختلفة: