العثور على نص في ورقة عمل Excel

تقوم هذه الواجهة البرمجية (REST API) بالبحث عن نص في ورقة عمل Excel.

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

POST http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/findText

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

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

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

اسم المُعامل النوع الموقع الوصف
name string path اسم المستند.
sheetName string path اسم ورقة العمل.
text string query النص المراد البحث عنه.
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 ناجح (OK) تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400 طلب غير صحيح (Bad Request) معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401 غير مخوّل (Unauthorized) رمز JWT غير صالح أو مفقود.
413 حجم البيانات كبير جدًا (Payload Too Large) حجم الملف المرفّع يتجاوز الحد المسموح به.
500 خطأ داخلي في الخادم (Internal Server Error) خطأ غير متوقع في الخادم.

كيفية استخدام PostWorksheetTextSearch API باستخدام SDKs

مواصفات PostWorksheetTextSearch API

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

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

استخدام SDKs الخاصة بـ Aspose.Cells Cloud

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

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