تحويل ملف إكسل إلى ماركداون – وثائق واجهة برمجة تطبيقات Aspose.Cells Cloud
تقوم هذه الواجهة البرمجية لواجهة REST بتحويل ملف جدول بيانات إلى ملف بصيغة ماركداون.
الأمان والمصادقة
تُعتبر واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب المصادقة باستخدام رمز JWT.
واجهة REST
POST https://api.aspose.cloud/v3.0/cells/convert/markdown
الأمان والمصادقة
تُعتبر واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب المصادقة باستخدام رمز JWT.
معاملات الاستعلام
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| password | string | query | كلمة المرور المطلوبة لفتح ملف إكسل. |
| storageName | string | query | اسم وحدة التخزين التي يقع عليها الملف. |
| checkExcelRestriction | bool | query | يُشير إلى ما إذا كان سيتم تطبيق القيود الخاصة بإكسل عند تعديل الخلايا أو الكائنات المرتبطة بها. |
| datafile | file | body | ملف إكسل المراد رفعه كجزء أول من المحتوى متعدد الأجزاء (multipart content). |
الاستجابة
ترجع الواجهة البرمجية كائن JSON من النوع FileInfo:
- FileInfo – كائن يحتوي على اسم الملف وحجمه ومحتواه المشفر بصيغة base64 للملف المُولَّد بصيغة ماركداون.
{
"Filename": "example.md",
"FileSize": 12345,
"FileContent": "base64_encoded_string"
}
استجابات الأخطاء
| رمز HTTP | الوصف | مثال محتوى JSON |
|---|---|---|
| 401 | غير مُعتمد – رمز مفقود أو غير صالح. | {"error":"Invalid access token."} |
| 400 | طلب غير صحيح – معلمات مطلوبة مفقودة أو تنسيق ملف غير صالح. | {"error":"The 'datafile' field is required."} |
| 500 | خطأ داخلي في الخادم – مشكلة غير متوقعة في الخادم. | {"error":"An unexpected error occurred."} |
كيفية استخدام واجهة PostConvertWorkbookToMarkdown باستخدام SDKs
###仕様 واجهة PostConvertWorkbookToMarkdown
يُعرّف 仕اء OpenAPI واجهة برمجة قابلة للوصول العام، ويسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يوضح المثال التالي كيفية استدعاء الواجهة البرمجية السحابية باستخدام cURL.
استخدام SDKs لـ Aspose.Cells Cloud
استخدام SDKs هو أسرع طريقة للتطوير. فتتولى SDKs معالجة التفاصيل منخفضة المستوى، مما يتيح لك التركيز على منطق أعمالك. يمكنك الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الرمز التالية كيفية استدعاء خدمات Aspose.Cells باستخدام SDKs مختلفة:
واجهات برمجية أخرى تنفذ نفس الوظيفة
- POST /cells/{name}/saveAs – تحفظ ملف إكسل بصيغة HTML مع إعدادات إضافية وتخزن النتيجة.
- PUT /cells/convert – تحول ملف إكسل إلى HTML مع خيارات إضافية وترد بالنتيجة في الاستجابة.
- GET /cells/{name} – تسترد ملف إكسل ويمكن تحويله إلى HTML مع إعدادات اختيارية.