استرجاع عناصر نصية من ملف عمل Excel|مستند

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

تقوم هذه واجهة برمجة تطبيقات REST بقراءة عناصر النص في ملف Excel.

GET https://api.aspose.cloud/v3.0/cells/{name}/textItems

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

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

معاملات الطلب

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

الاستجابة

{
  "Status":"OK",
  "Code":200,
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مصدق	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح به.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

كيفية استخدام واجهة برمجة تطبيقات GetWorkbookTextItems مع حزم تطوير البرمجيات (SDKs)

مواصفات واجهة برمجة تطبيقات GetWorkbookTextItems

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

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

الطلب

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

الاستجابة

{
  "Status": "string",
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

رموز الحالة الشائعة للاستجابة:

الرمز	الوصف
200	نجح الطلب؛ يتم إرجاع عناصر النص.
401	غير مصدق – رمز مفقود أو غير صالح.
403	ممنوع – صلاحيات غير كافية.
404	غير موجود – ملف العمل أو المورد غير موجود.
500	خطأ داخلي في الخادم – فشل غير متوقع.

استخدام حزم تطوير البرمجيات الخاصة بـ Aspose.Cells Cloud

يستخدم هذا المثال إصدار واجهة برمجة التطبيقات v3.0؛ راجع سجل التغييرات للحصول على الإصدارات الأحدث. استخدام حزمة تطوير البرمجيات (SDK) هو أفضل طريقة لتسريع عملية التطوير، حيث تتعامل الحزمة مع التفاصيل منخفضة المستوى وتركّز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات الخاصة بـ Aspose.Cells Cloud.

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