استبدال نصوص من ملفات Excel
REST API
يقوم هذا الـ REST API باستبدال البيانات في ملفات Excel.
POST https://api.aspose.cloud/v3.0/cells/replace
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتشترط المصادقة باستخدام رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| file | ملف | formData (multipart) | ملف Excel المراد معالجته. |
| text | نص | query | السلسلة النصية المراد استبدالها. |
| newtext | نص | query | النص البديل. |
| password | نص | query | كلمة المرور لورقة عمل محمية (اختياري). |
| sheetname | نص | query | اسم ورقة العمل المستهدفة (اختياري). |
الاستجابة
{
"Status":"OK",
"Code":200,
"Files": [
{
"Filename" : "[اسم الملف1]",
"Filesize" : [حجم الملف],
"FileContent" : "[Base64String]"
},
{
"Filename" : "[اسم الملف2]",
"Filesize" : [حجم الملف],
"FileContent" : "[Base64String]"
},
{
"Filename" : "[اسم الملف3]",
"Filesize" : [حجم الملف],
"FileContent" : "[Base64String]"
}
]
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح (OK) | تمت عملية التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصادَق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حمل البيانات كبير جدًا (Payload Too Large) | حجم الملف المرفوع يتجاوز الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام API PostReplace باستخدام حزم التطوير (SDKs)
مواصفات API PostReplace
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات مُتاحة للعامة وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يُظهر المثال التالي كيفية إجراء مكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
عائلة حزم التطوير السحابية
استخدام حزمة التطوير (SDK) هو أفضل طريقة لتسريع عملية التطوير. فحزمة التطوير تُعالِج التفاصيل منخفضة المستوى وتركّز أنت على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للاطّلاع على قائمة كاملة بحزم تطوير Aspose.Cells Cloud.
يوضح أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات الويب الخاصة بـ Aspose.Cells باستخدام حزم تطوير مختلفة: