Compress
مرحبًا بكم في الوثائق الرسمية لخدمة Compress، واجهة برمجة تطبيقات خفيفة الوزن لكنها قوية صُممت لتقليل ملفات الجداول الإلكترونية إلى جزء صغير من حجمها الأصلي بطلب واحد وبسيط. في عالم البيانات اليوم، تقوم الفرق بتبادل الجداول التي تشمل كل شيء من القوائم البسيطة إلى النماذج المالية المعقدة، وحجم هذه الملفات الضخم يمكن أن يصبح تكلفة خفية—بطء التحميل، ارتفاع رسوم التخزين، وزيادة أوقات المعالجة للأنظمة اللاحقة. تحل Compress هذه المشكلات من خلال تقديم خدمة سحابية ذكية تحلل بنية الملف الداخلية، تزيل ما هو غير ضروري، وتعيد تعبئة المحتوى بصورة مُحسّنة ومضغوطة دون التضحية بسلامة البيانات أو قابلية القراءة. تُعد هذه الصفحة المصدر الوحيد للمعرفة، وتوجهكم عبر كل ما تحتاجون معرفته لبدء استخدام الواجهة بفعالية، من المصادقة وتنسيق الطلب إلى معالجة الأخطاء واستراتيجيات أفضل الممارسات للمعالجة الدفعة. سواءً كنتم مهندسين خلفيين يدمجون خطوط البيانات، مطوري واجهات أمامية يسعون لتحسين تجربة المستخدم عند تحميل الملفات، أو مديرين تقنيين مسؤولين عن تقليل استهلاك التخزين في مؤسستكم، سيوفر لكم هذا الدليل تعليمات واضحة خطوة بخطوة، مقتطفات شفرة بلغات متعددة، وأمثلة واقعية توضح كيفية تحقيق أفضل نتائج الضغط لمجموعة متنوعة من صيغ الجداول. خلال الوثائق ستجدون أقسامًا مخصصة للاعتبارات الأمنية—مثل تشفير TLS، رموز JWT الموقعة، ومعالجة البيانات المتوافقة مع GDPR—إلى جانب مؤشرات الأداء التي تُظهر زمن الاستجابة والنقل النموذجي تحت أحمال مختلفة. كما نضمن قسم أسئلة شائعة شامل يغطي السيناريوهات المتكررة، مصفوفة استكشاف الأخطاء وإصلاحها لتشخيص المشكلات بسرعة، وروابط إلى منتديات المجتمع حيث يمكنكم تبادل الخبرات مع مطورين آخرين يستخدمون Compress في بيئات الإنتاج. بنهاية هذا الدليل، ستكونون قادرين على ضبط بيئاتكم، إرسال طلب API مُشكل بشكل صحيح، وفهم ردود الحِزم، لتدمجوا الضغط بسلاسة في سير عملكم الحالي وتبدأوا في رؤية وفورات ملموسة في تكاليف التخزين وعرض النطاق الترددي على الفور. استكشفوا الأقسام التي تناسب دوركم ودعوا Compress تتولى تشغيل خفض حجم البيانات لتتمكنوا من التركيز على بناء تطبيقات أغنى وأكثر استجابة.
الميزات الرئيسية
جوهر واجهة Compress API يدور حول مجموعة ميزات غنية تجعل تقليل حجم الجداول عملية سهلة وموثوقة. أولاً وقبل كل شيء، تدعم الخدمة مجموعة واسعة من أنواع الملفات—بما في ذلك Apple Numbers، ملفات CSV وTSV البسيطة، بالإضافة إلى صيغ Microsoft Excel .xlsx و.xls—وبالتالي يمكنكم إرسال أي جدول تقريبًا دون الحاجة إلى خطوة تحويل مسبقة. على مستوى المحرك، يتم تنفيذ تحسينات متعددة المراحل: يتم تطبيع بنية XML أو الهيكل الثنائي الداخلي للملف، إزالة الأنماط المكررة، دمج تنسيقات الخلايا المتطابقة، حذف الصفوف والأعمدة المخفية التي لا تحتوي على بيانات، وتضغيط الكائنات المضمنة مثل الصور، المخططات، وجداول المحور باستخدام خوارزميات ضغط لا تفقد الجودة مخصصة لكل نوع من المحتوى. بالإضافة إلى ذلك، يكتشف API ويزيل البيانات الوصفية الزائدة، التعليقات، ومعلومات الإصدارات التي عادةً ما تُزيد من حجم الملف دون فائدة عملية. كل هذه العمليات تحدث في الوقت الحقيقي، وتُعيد النتائج في مليثانية للملفات حتى 50 ميغابايت، وتُوسّع بسلاسة إلى مستندات أكبر مع تنظيم ذكي للسرعة وإشعارات التقدم. الأمان مدمج—كل طلب يُنقل عبر HTTPS، ولا تُحتفظ الخدمة بنسخة من ملفكم بعد انتهاء نافذة المعالجة القصيرة، مما يضمن الامتثال للوائح الخصوصية الصارمة. من منظور المطور، صُممت الواجهة لتكون خالية من العوائق: طلب POST واحد إلى نقطة النهاية `/compress` مع إرفاق الملف كـ multipart/form‑data يُعيد استجابة JSON تحتوي على رابط تحميل الملف الجديد، الحجم الأصلي والمضغوط، ورقم تحقق للتأكيد. تسمح المعلمات الاختيارية بضبط مستوى الضغط، حفظ أوراق معينة، أو وضع قائمة بيضاء للكائنات المضمنة إذا كان من الضروري الحفاظ على النزاهة الكاملة للتطبيقات اللاحقة. تتوفر SDK شاملة للغات Python، Node.js، Java، وGo، كل منها يوفر طريقة غلاف مختصرة `compressSpreadsheet(filePath, options)` تُجردكم من طبقة HTTP بالكامل. توثيق معدل الطلبات ونقاط النهاية للتحميل الجماعي يتيح لكم معالجة آلاف الملفات في الساعة دون إرباك البنية التحتية، بينما يُحافظ المنطق المدمج لإعادة المحاولة وتدرج التراجع الأسي على استقرار خطوط الأنابيب ضد انقطاعات الشبكة المؤقتة. باختصار، تقدم Compress API حلاً سريعًا، آمنًا، وملائمًا للمطورين يقلل من بصمة تخزين الجداول، يسرّع نقل الملفات، ويسهّل تدفقات إدارة البيانات بندقة نقر واحدة.
مستندات
المعلمات
- AppRequest.CompressionLevel: مستوى الضغط من واحد إلى تسعة (1 إلى 9)
- UploadFileRequest.OperationId: هذا هو معرف العملية
- UploadFileRequest.Files: هذه هي الملفات التي تحتاج إلى تحميلها إلى خدماتنا عبر الإنترنت، يمكنك إعداد البيانات بطريقتك الخاصة ولكن يجب أن تتبع معيار ملف إدخال HTML.
استخدام النقطة النهائية
-
أرسل طلبًا يتضمن الملفات ورمز الوصول API للضغط
curl -X 'POST' \ 'https://api.sheetize.cloud/compress' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.CompressionLevel=2' \ -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 } -
أرسل طلبًا يتضمن اسم الملف واسم المجلد إلى API التنزيل
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - ستستلم الملف ويمكنك إما استخدامه أو إرساله ببساطة إلى الخطوة التالية في سير عملك.
