حذف جميع المخططات من ورقة عمل باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud
تقوم هذه الواجهة البرمجية REST بحذف جميع المخططات من ورقة العمل المحددة.
الخلفية – يُعد حذف جميع المخططات من ورقة العمل مفيدًا عندما تحتاج إلى إعادة ضبط التصميم البصري لورقة العمل، أو استبدال التصورات البصرية القديمة، أو إعداد ملف عمل لإعادة الاستخدام دون الاحتفاظ ببيانات المخططات السابقة.
قبل استدعاء الواجهة البرمجية، تأكد من استيفاء المتطلبات الأساسية التالية:
- توفر رمز JWT صالح للمصادقة.
- وجود ملف العمل في موقع ومسار التخزين المحددين.
- استخدام إصدار الواجهة البرمجية v3.0.
واجهة DeleteWorksheetClearCharts البرمجية
DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts
الأمان والمصادقة
تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud مصادقة مبنية على رمز JWT، وهي آمنة.
مُعاملات الطلب
| اسم المُعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف العمل. |
| sheetName | string | path | اسم ورقة العمل. |
| folder | string | query | المجلد الذي يُخزّن فيه ملف العمل. |
| storageName | string | query | اسم مساحة التخزين. |
رؤوس الطلب
| الرأس | الوصف |
|---|---|
| Authorization | Bearer <jwt token> |
| Accept | application/json |
| Content-Type | application/json (لا يوجد جسم للطلب) |
جسم الطلب
لا تتطلب عملية DELETE أي جسم طلب.
الاستجابة
{
"Status":"OK",
"Code":200
}
كود حالات HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | OK (تمت العملية بنجاح) | تم تطبيق الحذف بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب غير صالح) | مُعاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مصرّح) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حجم البيانات كبير جدًا) | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | خطأ غير متوقع في الخادم. |
أمثلة على استجابات الأخطاء
// 400 Bad Request
{
"Code": 400,
"Message": "مُعامل غير صالح: يُطلب 'sheetName'."
}
// 401 Unauthorized
{
"Code": 401,
"Message": "فشلت المصادقة. رمز JWT غير صالح."
}
// 413 Payload Too Large
{
"Code": 413,
"Message": "تجاوز حجم بيانات الطلب الحد الأقصى المسموح به."
}
// 500 Internal Server Error
{
"Code": 500,
"Message": "حدث خطأ غير متوقع في الخادم."
}
كيفية استخدام واجهة DeleteWorksheetClearCharts البرمجية مع SDKs
مواصفات واجهة DeleteWorksheetClearCharts البرمجية
تعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة علنًا، وتمكّنك من إجراء تفاعلات REST مباشرة من خلال متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء المكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.