فشردهسازی
به مستندات رسمی Compress خوش آمدید، API سبکوزن اما قدرتمندی که برای کاهش اندازهٔ فایلهای صفحهگسترده به کسری از حجم اولیه آنها با یک درخواست ساده و شهودی طراحی شده است. در دنیای امروز که دادهها محور همه چیز است، تیمها بهطور مداوم صفحات گستردهای را مبادله میکنند که از فهرستهای ساده تا مدلهای مالی پیچیده را شامل میشود، و حجم عظیم این فایلها میتواند بهسرعت به هزینهٔ پنهانی تبدیل شود — بارگذاریهای کندتر، هزینههای ذخیرهسازی بیشتر و زمان پردازش طولانیتر برای سیستمهای downstream. Compress این مشکلات را با ارائه سرویس بومی‑ابری که بهصورت هوشمند ساختار داخلی صفحهٔ گسترده شما را تجزیه و تحلیل میکند، بار اضافی را حذف میکند و محتوا را به شکل بهینه و فشرده تجدید بستهبندی میکند، بدون آنکه یکپارچگی یا قابلیت خواندن دادهها را فدا کند، رفع میکند. این صفحهٔ مستندات به عنوان منبع تک حقیقت برای شما عمل میکند و شما را در تمام مراحل مورد نیاز برای استفاده مؤثر از API راهنمایی میکند، از احراز هویت و قالببندی درخواست تا مدیریت خطا و استراتژیهای بهترین روش برای پردازش دستهای. چه شما یک مهندس بکاند باتجربه باشید که خطوط داده را یکپارچه میکنید، یک توسعهدهنده فرانت‑اند که به دنبال بهبود تجربه کاربر در هنگام بارگذاری فایلهاست، یا یک مدیر فناوری اطلاعات که وظیفهٔ کاهش هزینههای ذخیرهسازی در کل سازمان را دارد، این راهنما دستورالعملهای واضح قدم به قدم، اسنیپتهای کد در چندین زبان و مثالهای واقعی را فراهم میکند که نشان میدهد چگونه بهترین نتایج فشردهسازی را برای انواع مختلف فرمتهای صفحهگسترده به دست آورید. در سراسر مستندات بخشهای اختصاصی درباره ملاحظات امنیتی — مانند رمزنگاری TLS، توکنهای JWT امضا شده و مدیریت داده منطبق با GDPR — همراه با بنچمارکهای عملکردی که تأخیر و توان پردازشی معمول را تحت بارهای کاری مختلف نشان میدهد، خواهید یافت. همچنین یک بخش FAQ جامع که سناریوهای رایج را پوشش میدهد، یک ماتریس عیبیابی برای تشخیص سریع مشکلات، و لینکهای به انجمنهای جامعه که میتوانید بینشهای خود را با دیگر توسعهدهندگانی که Compress را در تولید به کار میبرند به اشتراک بگذارید، گنجاندهایم. تا پایان این راهنما باید بتوانید با اطمینان محیطهای خود را پیکربندی کنید، یک فراخوانی API بهدرستی ساختهشده ارسال کنید و محتوای پاسخها را تفسیر کنید، تا بتوانید بهصورت یکپارچه فشردهسازی را در جریان کارهای موجود خود جاسازی کنید و فوراً صرفهجویی ملموسی در هزینههای ذخیرهسازی و پهنای باند شبکه مشاهده کنید. وارد شوید، بخشهای متناسب با نقش خود را بررسی کنید و بگذارید Compress حملونقل سنگین کاهش دادهها را بر عهده بگیرد تا شما بتوانید بر ساخت برنامههای غنیتر و پاسخگوتر تمرکز کنید.
ویژگیهای اصلی
هستهٔ API فشردهسازی حول مجموعهای غنی از ویژگیها میچرخد که کاهش حجم صفحات گسترده را هم بهصورت بیدردسر و هم قابل اعتماد میسازد. در درجهٔ اول، سرویس از طیف وسیعی از انواع فایلها پشتیبانی میکند — شامل Apple Numbers، فایلهای ساده CSV و TSV، و همچنین فرمتهای .xlsx و .xls مایکروسفت اکسل — به طوری که میتوانید تقریباً هر صفحه گستردهای را که مواجه میشوید بدون نیاز به گام پیشتبدیل ارسال کنید. در پشت صحنه، موتور بهصورت چند مرحلهای بهینهسازی میکند: ساختار داخلی XML یا باینری فایل را نرمالسازی میکند، سبکهای تکراری را حذف میکند، قالبهای سلولی یکسان را ادغام میکند، ردیفها و ستونهای مخفی بدون داده را برمیدارد و اشیای توکار مانند تصاویر، نمودارها و جدولهای محوری را با اعمال الگوریتمهای فشردهسازی بدون ضرر که برای هر بار داده بهطور خاص تنظیم شدهاند، فشرده میسازد. علاوه بر این، API متادیتا، نظرات و اطلاعات نسخهگذاری تکراری را که معمولاً حجم فایل را افزایش میدهند اما بهندرت کاربرد عملی دارند، شناسایی و حذف میکند. تمام این عملیات بهصورت زمان واقعی انجام میشود و نتایج را در میلیثانیه برای فایلهای تا ۵۰ مگابایت ارائه میدهد و بهصورت سازگار به اسناد بزرگتر با محدودیتهای ملایم و فراخوانیهای پیشرفت مقیاس میبندد. امنیت درونساخت است — هر درخواست از طریق HTTPS انتقال مییابد و سرویس هیچ نسخهای از فایل شما را پس از پنجره پردازش کوتاه نگه نمیدارد، که تضمینکننده رعایت مقررات حریم خصوصی سختگیرانه است. از دیدگاه توسعهدهنده، API طوری طراحی شده است که تا حد امکان بدون اصطکاک باشد: یک POST ساده به نقطهٔ پایانی `/compress` همراه با فایل بهصورت multipart/form‑data، یک پاسخ JSON حاوی URL دانلود فایل جدید، اندازهٔ اصلی و فشرده، و یک چکسام برای تأیید صحت برمیگرداند. پارامترهای اختیاری به شما اجازه میدهند سطح فشردهسازی را دقیقاً تنظیم کنید، شیتهای خاصی را حفظ کنید یا برخی اشیای توکار را در فهرست سفید قرار دهید اگر نیاز به حفظ کامل صحت برای برنامههای جانبی دارید. SDKهای جامع برای Python، Node.js، Java و Go در دسترس هستند که هر کدام متد پوششی مختصری — `compressSpreadsheet(filePath, options)` — ارائه میدهند که لایهٔ HTTP را بهطور کامل انتزاع میکند. مستندات دقیق محدودیت نرخ و نقاط پایانی بارگذاری انبوه به شما امکان میدهد تا هزاران فایل در ساعت پردازش کنید بدون فشار بر زیرساختهای خود، در حالی که منطق باز retry داخلی و مدیریت بازگشت تصاعدی اطمینان میدهد که خطوط لوله شما در برابر نوسانات موقت شبکه محکم باقی بمانند. بهطور خلاصه، 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' - فایل را دریافت میکنید و میتوانید از آن استفاده کنید یا به مرحله بعدی جریان کار خود منتقل کنید.
