المقسّم
مرحبًا بكم في الدليل الشامل لواجهة برمجة تطبيقات تقسيم الجداول الخاصة بنا — حل قوي صُمم لتبسيط معالجة المستندات متعددة الأوراق عبر مجموعة متنوعة من الصيغ الشائعة. سواءً كنت تتعامل مع دفاتر إكسل التقليدية (.xlsx, .xls, .xlsm)، أو ملفات CSV و TSV النصية، أو Apple Numbers (.numbers)، أو أي من صيغ الملفات المدعومة الأخرى، تقوم هذه الواجهة تلقائيًا باستخراج كل ورقة أو تبويب وحفظه كملف مستقل. هذه القدرة مثالية للمطورين الذين يحتاجون إلى تقسيم مجموعات بيانات ضخمة ومتماسكة إلى قطع قابلة للإدارة لسير عملٍ معياري، أو لعزل المعلومات الحساسة، أو لتقديم مجموعات بيانات مخصصة لأصحاب المصلحة المختلفين. يشرح التوثيق أدناه مفاهيم الواجهة الأساسية، وآليات المصادقة، وهيكل الطلب، ومعالجة الاستجابة، موفرًا لك كل ما تحتاجه لتكامل هذه الوظيفة القوية بنقرة واحدة فقط.
الميزات الرئيسية
مصمم للسرعة والاعتمادية، تستفيد الواجهة البرمجية من محركات تحليل محسّنة لضمان معالجة سريعة حتى لدفاتر العمل التي تحتوي على عشرات الأوراق وآلاف الصفوف. يَتَبع تصميمها الصديق للمطورين أساليب HTTP القياسية، وحمولات JSON، ورموز الحالة الواضحة، مما يتيح لك دمجها بسلاسة في الأنابيب الحالية أو الوظائف السحابية. طوال الدليل ستجد أمثلة عملية، وتوصيات لأفضل الممارسات، ونصائح لاستكشاف الأخطاء وإصلاحها تساعدك على تجنّب المشكلات الشائعة وتعظيم الأداء. بنهاية هذا التوثيق، ستكون قادرًا على تحويل جداول معقدة متعددة الأوراق إلى ملفات منفصلة ونظيفة — مما يمنحك القدرة على تجزئة البيانات بدقة بأقل جهد. انطلق واكتشف كيف يمكن لطلب واحد أن يحول دفتر عمل معقّد إلى مجموعة أصول جاهزة للاستخدام.
المستندات
المعلمات
- UploadFileRequest.OperationId: هذا معرف العملية
- UploadFileRequest.Files: هذه هي الملفات التي تحتاج إلى رفعها إلى خدماتنا عبر الإنترنت، يمكنك إعداد البيانات بطريقتك الخاصة لكن يجب أن تتبع معيار ملف الإدخال html.
-
أرسل طلبًا يتضمن الملفات ورمز الوصول واجهة برمجة تطبيقات المقسّم
curl -X 'POST' \ 'https://api.sheetize.cloud/splitter' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -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' - ستستلم الملف ويمكنك إما استخدامه أو إرساله ببساطة إلى الخطوة التالية من سير عملك.
