التحويل
واجهة برمجة تطبيقات البيانات الوصفية هي خدمة مُصمَّدة خصيصًا ومناسبة للمطورين، تضع التحكم الكامل في بيانات وصفية ملفات الجداول الإلكترونية بين يديك عبر طلب HTTP واحد فقط. سواء كنت تتعامل مع صيغ المكتب الكلاسيكية مثل إكسل (.xlsx, .xls)، أو ملفات محددة الفواصل مثل CSV (.csv) و TSV (.tsv)، أو حتى مستندات Apple Numbers (.numbers)، فإن الواجهة تُبسط تعقيدات تحليل الملفات وتتيح لك قراءة أو إضافة أو تعديل الخصائص الوصفية الرئيسية في غضون مليثثانية. تخيّل أن تتمكن من معالجة آلاف التقارير أو مجموعات بيانات البحث أو القوائم المالية دفعةً واحدة، مع إثراء كل ملف بمجموعة متسقة من معلومات المؤلف والعناوين والمواضيع والوصف وقوائم الكلمات المفتاحية وحتى مجموعات العلامات المخصصة التي تُحددها تطبيقك. هذا المستوى من الأتمتة لا يوفر ساعات لا حصر لها من التعديل اليدوي فحسب، بل يضمن أيضًا أن كل ملف تُرسله للعملاء أو المتعاونين أو أنظمة الأرشفة يحمل البيانات الوصفية الدقيقة المطلوبة للفهرسة والامتثال والقابلية للاكتشاف. تعمل الخدمة بقبول إما بايتات الملف الخام أو عنوان URL يشير إلى مستند مستضاف في السحابة، ثم تُعيد ملفًا جديدًا مكتملًا مع تطبيق تغييرات البيانات الوصفية المطلوبة دون تعديل تنسيق البيانات الأصلي أو الصيغ.
الميزات الرئيسية
نظرًا لأن الواجهة البرمجية لا تحتفظ بالحالة، يمكنك بسهولة دمجها في خطوط أنابيب CI/CD، أو وظائف الدُفعات على الخادم، أو أدوات جافا سكريبت على جانب العميل، مما يضمن أن كل تصدير من تطبيق ويب أو كل نسخة احتياطية دورية يحتوي على معلومات الأصل الصحيحة. الأمان مدمج: جميع الطلبات تُجرى عبر TLS، والحمولات مُشفَّرة من الطرف إلى الطرف، وتدعم الواجهة مفتاح API أو مصادقة OAuth 2.0، مما يسمح لك بتقييد الوصول إلى الخدمات الموثوقة فقط. يتعامل المحرك الأساسي مع مكتبات تحليل مُحسّنة لكل صيغة مدعومة، مما يضمن أن حتى دفاتر إكسل الضخمة التي تحتوي على مئات الأوراق تُعالج بسرعة؛ معظم الطلبات المعتادة تُكتمل في أقل من 200 مللي ثانية. عمليًا، يعني ذلك أنك تستطيع إنشاء زر “إضافة بيانات وصفية” سلس داخل منتجك يُرسل الملف إلى الخدمة، يتلقى النسخة المُعَزَّزة، ويقدمها للتنزيل الفوري—كل ذلك دون مغادرة المستخدم للواجهة. كما تُعيد الواجهة سجلات عمليات مفصلة، حتى يتمكن المطورون من التحقق برمجيًا من أن الحقول المتوقعة تم تحديثها، أو إرجاع التغييرات إذا لزم الأمر، أو تفعيل خطوات معالجة إضافية بناءً على قيم العلامات المخصصة. من خلال توفير نقطة نهاية REST موحدة وغير مرتبطة بلغة برمجة، تُلغي واجهة البيانات الوصفية الحاجة إلى صيانة مكتبات متعددة خاصة بكل صيغة، وتقلّص عبء الصيانة، وتضمن التوافق المستقبلي مع معايير الجداول الجديدة التي قد تظهر. سواء كنت بائع SaaS يسعى لإدراج معلومات الترخيص، أو مؤسسة بحثية تُصنّف مجموعات البيانات، أو مؤسسة تُؤتمت الامتثال الوثائقي، فإن هذه الواجهة تقدم طريقة سريعة، آمنة، وقابلة للتوسع لإثراء ملفاتك بطلب واحد بسيط.
المستندات
المعاملات
- AppRequest.Metadata: مع PropertyName و PropertyValue
- AppRequest.MetadataJson: إذا لم تكن تستخدم هيكل البيانات الوصفية، فعليك استخدام النوع json.
- UploadFileRequest.OperationId: هذه هي الملفات التي تحتاج إلى رفعها إلى خدماتنا عبر الإنترنت، يمكنك إعداد البيانات بطريقتك الخاصة ولكن يجب أن تتبع معيار ملف الإدخال html.
- UploadFileRequest.Files: هذه هي الملفات التي تحتاج إلى رفعها إلى خدماتنا عبر الإنترنت، يمكنك إعداد البيانات بطريقتك الخاصة ولكن يجب أن تتبع معيار ملف الإدخال html.
-
أرسل طلبًا يتضمن الملفات ورمز الوصول واجهة برمجة تطبيقات البيانات الوصفية
curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
ستستجيب الخدمة بعنوان URL للتحميل للملف المعالج، في هذا المثال هو:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 } -
أرسل طلبًا يتضمن اسم الملف واسم المجلد إلى واجهة برمجة تطبيقات التحميل
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - ستستلم الملف ويمكنك إما استخدامه أو ببساطة إرساله إلى الخطوة التالية في سير عملك.
