Compress
ברוכים הבאים לתיעוד הרשמי של Compress, ממשק API קל משקל אך חזק שנועד לצמצם קבצי גיליונות אלקטרוניים לשבר קטן מהגודל המקורי שלהם בבקשה אחת אינטואיטיבית. בעידן הנוכחי המונחה בנתונים, צוותים מחליפים באופן מתמיד גיליונות שמכילים הכל מרשימות פשוטות עד מודלים פיננסיים מורכבים, והנפח הרב של קבצים אלו יכול להפוך לעלות נסתרת — העלאות איטיות, תשלומי אחסון גבוהים יותר וזמני עיבוד ארוכים למערכות המשך. Compress מתמודדת עם נקודות כאב אלו על‑ידי שירות מבוסס ענן שמנתח בחוכמה את המבנה הפנימי של הגיליון, מסיר מטענים מיותרים ומארז את התוכן בצורה אופטימלית ומדחסת מבלי לוותר על שלמות הנתונים או קריאותם. דף תיעוד זה משמש כמקור אמת יחיד, שמנחה אותך דרך כל מה שאתה צריך לדעת כדי להתחיל להשתמש ב‑API בצורה יעילה, כולל אימות, פורמט הבקשה, טיפול בשגיאות ואסטרטגיות מומלצות לעיבוד מקבילי. בין אם אתה מהנדס backend מנוסה המשייך צינורות נתונים, מפתח front‑end המבקש לשפר את חוויית המשתמש בהעלאת קבצים, או מנהל IT שאחראי על הפחתת העומס האחסוני בארגון, מדריך זה יספק הוראות ברורות שלב‑אחר‑שלב, קטעי קוד במספר שפות, ודוגמאות מציאותיות המדגימות כיצד להגיע לתוצאות הדחיסה הטובות ביותר במגוון רחב של פורמטים של גיליונות. לאורך התיעוד תמצאו סעיפים ייעודיים לשיקולי אבטחה — כגון הצפנת TLS, אסימוני JWT חתומים, וטיפול נתונים בהתאם ל‑GDPR — לצד מדדי ביצועים המדגימים את השהייה והקצב typical תחת עומסים שונים. אנו כוללים גם שאלות נפוצות (FAQ) המתקשרות לתרחישים נפוצים, מטריצת פתרון בעיות לאבחון מהיר, וקישורים לפורומים קהילתיים שבהם ניתן לשתף תובנות עם מפתחים אחרים המשתמשים ב‑Compress בייצור. בסיום המדריך, תרגישו בטוחים בהגדרת הסביבות, שליחת קריאת API נכונה, ופענוח תוצאות התגובה, כך שתוכלו לשלב באופן חלק דחיסה בתהליכים קיימים ולחסוך מיידית בעלויות אחסון ורוחב פס רשת. הצטרפו, חקרו את המחלקות המתאימות לתפקידכם, ותנו ל‑Compress לבצע את העבודה הכבדה של הפחתת נתונים כדי שתוכלו להתמקד בבניית אפליקציות עשירות ותגובה יותר.
תכונות מרכזיות
הליבה של ממשק ה‑API של Compress מתבססת על ערכת תכונות עשירה שהופכת את צמצום הגיליונות לפשוט ולמהימן. בראש ובראשונה, השירות תומך במגוון רחב של סוגי קבצים — כולל Apple Numbers, קבצי CSV ו‑TSV רגילים, וכן פורמטים של Microsoft Excel .xlsx ו‑.xls — כך שניתן לשלוח כמעט כל גיליון שעמודו ללא צורך בצעד המרה מוקדם. במנגנון הפנימי, המנוע מבצע אופטימיזציה מרובת‑שלבים: הוא מנרמל את המבנה הפנימי של הקובץ (XML או בינארי), מסיר סגנונות משוכפלים, ממזג פורמטים של תאים זהים, מוחק שורות ועמודות מוסתרות שאין בהן נתונים, ומדחס חפצים משולבים כגון תמונות, גרפים וטבלאות ציר באמצעות אלגוריתמים לדחיסה ללא איבוד המתאימים לכל סוג תוכן. בנוסף, ה‑API מזהה ומסיר מטא‑דאטה מיותר, תגובות וגרסאות מידע שלרוב מגדילים את גודל הקובץ אך כמעט ולא משמשים למטרה פונקציונלית. כל הפעולות מתבצעות בזמן אמת, ומספקות תוצאות במילישניות לקבצים עד 50 מ״ב, ומתעלות בצורה חלקה לקבצים גדולים יותר עם הגבלות קצב והודעות התקדמות מתאימות. האבטחה מובנית — כל בקשה מועברת ב‑HTTPS והשירות אינו שומר עותק של הקובץ מעבר לחלון העיבוד הקצר, מה שמבטיח עמידה בתקנות פרטיות מחמירות. מנקודת מבט של מפתח, ה‑API מעוצב ללא חיכוכים: בקשת POST יחידה ל‑`/compress` עם הקובץ המצורף כ‑multipart/form‑data מחזירה תגובה בפורמט JSON הכוללת כתובת הורדה של הקובץ החדש, גודל המקורי והדחוס, ו‑checksum לאימות. פרמטרים אופציונליים מאפשרים לכוונן רמת דחיסה, לשמר גיליונות ספציפיים, או לכלול ברשימה לבנה חפצים משולבים אם יש צורך לשמר נאמנות מלאה ליישומים המשניים. קיימים SDKים מקיפים עבור Python, Node.js, Java ו‑Go, שכל אחד מציע מתודולוגיה מקוצרת — `compressSpreadsheet(filePath, options)` — המפשטת את שכבת HTTP לחלוטין. תיעוד מפורט של מגבלות קצב ונקודות קצה להעלאה בקבוצות מאפשרים לעבד אלפי קבצים לשעה ללא עומס על התשתית, בעוד שהגיוני‑החזרה המובנה והקפיצה האקספוננציאלית שומרות על יציבות הצינורות בפני תקלות רשת זמניות. בקיצור, ה‑Compress API מספק פתרון מהיר, מאובטח וידידותי למפתחים שמקטין את רצועת אחסון הגיליונות, מאיץ את העברת הקבצים ומפשט תהליכי ניהול נתונים בפנייה אחת פשוטה.
מסמכים
פרמטרים
- AppRequest.CompressionLevel: רמת הדחיסה מ‑1 עד 9 (1 עד 9)
- UploadFileRequest.OperationId: זהו מזהה פעולה
- UploadFileRequest.Files: אלו הם הקבצים שעליכם להעלות לשירותים המקוונים שלנו, ניתן להכין את הנתונים בדרככם, אך חייבים לעמוד בתקן של קובץ קלט HTML.
השתמשו בנקודת הקצה
-
שלחו בקשה הכוללת את הקבצים ואת אסימון הגישה Compress 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' -
השירות יענה עם כתובת הורדה של הקובץ המעובד, בדוגמה זו היא:
{ "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' - תקבלו את הקובץ ואתם יכולים להשתמש בו או להעבירו לשלב הבא של תהליך העבודה שלכם.
