استرجاع البيانات الوصفية من ملفات Excel - واجهة Aspose.Cells Cloud API

تقوم هذه الواجهة 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ات مختلفة: