إنشاء مصنف إكسل فارغ باستخدام واجهة Aspose.Cells Cloud API

تقوم هذه الواجهة البرمجية REST بإنشاء مصنف فارغ.

PutWorkbookCreate API

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

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

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

معاملات الاستعلام

اسم المعامل النوع الوصف
templateFile string مسار ملف مصنف قالب لاستخدامه كأساس (اختياري).
dataFile string مسار ملف بيانات لتعبئة المصنف به (اختياري).
isWriteOver boolean true للكتابة فوق الملف الموجود؛ و false خلاف ذلك.
folder string المجلد الوجهة للمصنف الذي تم إنشاؤه (اختياري).
storageName string اسم خدمة التخزين المراد استخدامها.

معامل جسم الطلب

اسم المعامل النوع الوصف
data file المحتوى الثنائي لملف المصنف المراد إنشاؤه.

الاستجابة

{
    "Name": "ResponseFile",
    "DataType": {
        "Identifier": "File",
        "Reference": "Stream",
        "Name": "file"
    }
}

رموز حالة HTTP

الرمز المعنى وقت الإرجاع
200 OK تم إنشاء المصنف بنجاح التدفق الطبيعي
201 Created تم إنشاء المصنف (استجابة بديلة) عندما تُعيد الواجهة البرمجية حالة “تم الإنشاء”
400 Bad Request معاملات غير صالحة خطأ من جانب العميل
401 Unauthorized رمز مفقود أو غير صالح خطأ في المصادقة
409 Conflict الملف موجود و isWriteOver=false تضارب مع الملف الموجود

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

مواصفات PutWorkbookCreate API

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

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب. تضمين رأس Authorization مع رمز وصول OAuth2/JWT ساري المفعول. بالنسبة لمصنف فارغ، يكون جسم الطلب اختياريًا؛ وإذا احتجت إلى رفع ملف، أضف --data-binary @empty.xlsx كما هو موضح أدناه.

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

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

توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام SDKs مختلفة:

كيفية إنشاء ملف مصنف Excel باستخدام ملف قالب