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

تسترجع واجهة برمجة تطبيقات Aspose.Cells Cloud تعليق ورقة العمل باستخدام اسم الخلية.

المتطلبات المسبقة: لاستدعاء هذه العملية، يجب تضمين رمز وصول JWT صالح في رأس Authorization (بالصيغة Bearer <jwt token>). ويمكنك الحصول على الرموز من خلال عملية المصادقة الموضحة في دليل المصادقة.

واجهة برمجة التطبيقات GetWorksheetComment

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

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

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

معلمات الطلب

اسم المعلمة	النوع	الموقع (مسار URL / سلسلة الاستعلام)	الوصف
name	string	مسار URL	اسم ملف Excel.
sheetName	string	مسار URL	اسم ورقة العمل التي يحتوي التعليق عليها.
cellName	string	مسار URL	عنوان الخلية (مثل A1) التي يتم استرجاع تعليقها.
folder	string	سلسلة الاستعلام	مسار المجلد الذي يخزن فيه المستند.
storageName	string	سلسلة الاستعلام	اسم خدمة التخزين.

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

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

الطلب

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

الاستجابة

{
  "Comment": {
    "CellName": "A1",
    "Author": "roy.wang",
    "HtmlNote": "",
    "Note": "Aspose.Cells Cloud.",
    "AutoSize": "True",
    "IsVisible": "True",
    "Width": 30,
    "Height": 10,
    "TextHorizontalAlignment": "Bottom",
    "TextOrientationType": "TopToBottom",
    "TextVerticalAlignment": "Bottom"
  },
  "Code": 200,
  "Status": "OK"
}

الاستجابة: تُعيد واجهة برمجة التطبيقات كائن JSON يحتوي على كائن Comment به الحقول التالية:

الحقل	النوع	الوصف
`CellName`	string	عنوان الخلية (مثل A1).
`Author`	string	اسم مؤلف التعليق.
`HtmlNote`	string	محتوى التعليق بصيغة HTML (إن وُجد).
`Note`	string	النسخة النصية العادية من التعليق.
`AutoSize`	boolean	يُشير إلى ما إذا كانت صندوق التعليق تحجم تلقائيًا.
`IsVisible`	boolean	يُحدد ما إذا كان التعليق مرئيًا.
`Width`	integer	عرض صندوق التعليق (بالأحرف).
`Height`	integer	ارتفاع صندوق التعليق (بالأحرف).
`TextHorizontalAlignment`	string	المحاذاة الأفقية للنص (مثل Bottom).
`TextOrientationType`	string	اتجاه النص (مثل TopToBottom).
`TextVerticalAlignment`	string	المحاذاة العمودية للنص (مثل Bottom).

الأخطاء الشائعة

401 Unauthorized (غير مُصرّح) – تأكّد من أن رمز JWT صالح وغير منتهٍ ومُدرج بشكل صحيح في رأس Authorization.
404 Not Found (غير موجود) – تأكّد من أن اسم الملف واسم ورقة العمل وعنوان الخلية صحيحان، وأن الملف موجود في المجلد أو التخزين المحدّد.
500 Internal Server Error (خطأ داخلي في الخادم) – تحقق من وجود بيانات مُشكّلة في حمولة الطلب، وتأكد من أن الخدمة تعمل بشكل سليم.

رموز حالات HTTP

الرمز	المعنى	الوصف
200	OK (تم بنجاح)	تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request (طلب غير صالح)	معلمات ناقصة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	Unauthorized (غير مُصرّح)	رمز JWT غير صالح أو مفقود.
413	Payload Too Large (حمولة كبيرة جدًا)	ملف مرسل يتجاوز الحد الأقصى للحجم.
500	Internal Server Error (خطأ داخلي في الخادم)	خطأ غير متوقع في الخادم.

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

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

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

API حذف تعليق ورقة العمل – Aspose.Cells Cloud إضافة تعليق إلى ورقة العمل