حساب صيغة الخلية – وثائق واجهة برمجة تطبيقات Aspose.Cells Cloud
واجهة برمجة تطبيقات REST
تحسب هذه واجهة برمجة تطبيقات REST صيغة الخلية في ملف Excel.
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/{cellName}/calculate
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة مبنية على رمز JWT.
معطيات الطلب
| اسم المعطى | النوع | موقع المعطى (path/query/body) | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف Excel (مثال: Book1.xlsx). |
| sheetName | string | path | اسم ورقة العمل التي تحتوي على الخلية. |
| cellName | string | path | عنوان الخلية المراد حسابها (مثال: A1). |
| options | object | body | كائن JSON يحتوي على خيارات الحساب (انظر جدول كائن الخيارات). |
| folder | string | query | المجلد في التخزين حيث يوجد الملف. |
| storageName | string | query | اسم مجلد تخزين Aspose Cloud. |
كائن الخيارات
| الحقل | النوع | الوصف | القيمة الافتراضية |
|---|---|---|---|
| CalcStackSize | string | الحد الأقصى لحجم كومة الحساب. | "1" |
| IgnoreError | boolean | إذا كانت القيمة true، يتم تجاهل أخطاء الحساب وتُضبط قيمة الخلية على #N/A. |
false |
| Recursive | boolean | يُفعّل الحساب التكراري للخلايا التابعة. | false |
| Precision | string | عدد المنازل العشرية للنتائج الرقمية. | "15" |
| UseThreading | boolean | يُفعّل الحساب متعدد الخيوط (multi-threaded). | false |
الاستجابة
{
"Status":"OK",
"Code":200
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح (OK) | تم تطبيق الحساب بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معطيات مفقودة أو غير صحيحة (مثال: نوع ملف غير مدعوم). |
| 401 | غير مُصادق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حمل البيانات كبير جدًا (Payload Too Large) | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostCellCalculate API باستخدام مكتبات SDK
مواصفات واجهة PostCellCalculate API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام وتسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب بسهولة. يُظهر المثال التالي كيفية استدعاء واجهة برمجة تطبيقات Cloud باستخدام cURL. احصل أولًا على رمز JWT عن طريق المصادقة ضد النقطة النهائية /connect/token واستبدل <jwt token> بقيمة الرمز.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
استخدام مكتبة SDK هو أفضل طريقة لتسريع التطوير. فالمكتبة SDK تُجيزك من تفاصيل المستوى المنخفض وتركّز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر واجهة الويب باستخدام مكتبات SDK مختلفة: