استرجاع البيانات الوصفية من ملفات Excel - واجهة Aspose.Cells Cloud API
Contents
[
Hide
]
تقوم هذه الواجهة REST API باسترجاع البيانات الوصفية من ملف أو أكثر من ملفات Excel.
يجب أن يتضمّن الطلب رأس Authorization: Bearer <access_token> يُحصل عليه عبر تدفق بيانات اعتماد العميل OAuth 2.0.
المتطلبات المسبقة: لاستدعاء هذه النهاية (endpoint)، يجب أن تمتلك رمز وصول (access token) ساري المفعول تم الحصول عليه من نقطة نهاية رموز OAuth 2.0 الخاصة بـ Aspose Cloud. مثال على طلب curl لاسترداد رمز وصول:
curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=<your_client_id>&client_secret=<your_client_secret>"
واجهة REST API
POST https://api.aspose.cloud/v3.0/cells/metadata/get
معلمة الاستعلام (Query Parameter)
| اسم المعلمة | النوع | الوصف |
|---|---|---|
| type | string | ALL / BuiltIn / Custom – يحدّد مجموعات البيانات الوصفية المراد إعادتها. |
معلمة جسم الطلب
| اسم المعلمة | النوع | الوصف |
|---|---|---|
| ملف Excel | ملف بيانات | ملف Excel المزوّد كجزء أول من الطلب متعدد الأجزاء (multipart request). |
الاستجابة
[
{
"Name": "Author",
"Value": "John Doe",
"BuiltIn": true,
"IsReadOnly": false
},
{
"Name": "CustomProp1",
"Value": "Custom Value",
"BuiltIn": false,
"IsReadOnly": false
}
]
| الرمز | المعنى | الحالة |
|---|---|---|
| 200 | نجاح | تم إرجاع البيانات الوصفية. |
| 400 | طلب غير صالح | ملف مفقود أو استعلام غير صحيح. |
| 401 | غير مُصادَق عليه | رمز وصول غير صالح أو مفقود. |
| 404 | غير موجود | الملف المحدّد غير موجود. |
| 500 | خطأ داخلي في الخادم | فشل غير متوقّع في الخادم. |
تُعيد الواجهة هذه الرموز القياسية لحالة HTTP مع كائن JSON للاستجابة بالخطأ عند الضرورة.
عائلة SDK في السحابة
استخدام SDK يُسرّع التطوير من خلال التعامل مع التفاصيل منخفضة المستوى. راجع مستودع GitHub للاطّلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKات مختلفة: