Clear
تم تصميم Clear Spreadsheet API لتكون الحل النهائي للمطورين الذين يحتاجون إلى مسح العناصر غير المرغوب فيها من ملفات جداول البيانات برمجياً وباستدعاء واحد موثوق. توفر هذه الصفحة دليلًا شاملاً يرافقك خطوة بخطوة لدمج الخدمة في تطبيقاتك بثقة. نبدأ بنظرة عامة على المفاهيم الأساسية للواجهة، موضحين كيفية تفسير الخدمة لمختلف صيغ الجداول—من ملفات Office Open XML الحديثة (.xlsx) إلى ملفات Excel الثنائية القديمة (.xls)، بالإضافة إلى Apple Numbers، CSV، TSV وغيرها من صيغ الجداول. فهم الفروق بين هذه الصيغ ضروري لأن كل صيغة تخزن الروابط، الصور، المخططات، والكائنات المدمجة بطرق مختلفة؛ وتقوم Clear API بتجريد هذه التعقيدات لتقدم واجهة موحدة تعمل عبر جميع الصيغ.
الميزات الرئيسية
بعد ذلك ستجد دليلًا تفصيليًا لسير عمل المصادقة. يستخدم النظام مفاتيح API القياسية في الصناعة ورمز OAuth 2.0 اختياري لضمان أن العملاء المصرح لهم فقط يمكنهم استدعاء عمليات مسح البيانات. يتم تغطية ممارسات الأمان مثل تدوير المفاتيح، وضع القوائم البيضاء لعناوين IP، والنقل المشفر عبر HTTPS بعمق، لتتمكن من حماية البنية التحتية الخاصة بك وبيانات المستخدمين النهائيين. بعد المصادقة، يقدم قسم "البدء السريع" عينة كود متعددة اللغات (cURL، Python، JavaScript، .NET، Java) توضح كيفية إنشاء حموله الطلب، إرفاق ملف الجداول، وتفسير الاستجابة. العينة تعرض أبسط طلب ممكن — مفتاح API الخاص بك، بيانات الملف، وقائمة اختيارية لأنواع العناصر التي تريد مسحها — لتجسد وعد الواجهة بـ "استدعاء واحد بسيط".
المستندات
المعلمات
- format: اسم العملية، القيم الممكنة: clearAll، clearHyperlinks، clearTables، clearPictures، clearShapes، clearComments، clearCharts، clearOleObjects، clearTextboxes، clearScenarios
- AppRequest.OperationTables: اسم العملية، القيم الممكنة: clearAll، clearHyperlinks، clearTables، clearPictures، clearShapes، clearComments، clearCharts، clearOleObjects، clearTextboxes، clearScenarios
- UploadFileRequest.OperationId: هذا هو معرّف العملية
- UploadFileRequest.Files: هذه هي الملفات التي يجب رفعها إلى خدماتنا عبر الإنترنت؛ يمكنك إعداد البيانات بطريقتك الخاصة لكن يجب أن تتبع معيار إدخال ملفات HTML.
استخدام النقطة النهائية
-
أرسل طلبًا يتضمن الملفات ورمز الوصول Clear API
curl -X 'POST' \ 'https://api.sheetize.cloud/clear' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.OperationTables=clearHyperlinks' \ -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 } -
أرسل طلبًا يتضمن اسم الملف واسم المجلد إلى Download API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - ستستلم الملف ويمكنك إما استخدامه أو تمريره إلى الخطوة التالية في سير العمل الخاص بك.
