השוואה

ברוכים הבאים למרכז התיעוד הרשמי של API ההשוואה, פתרון בעל יעוד מיוחד שמממיר את המשימה המייגעת של שליטה בגירסאות של גיליונות אל זרימה חלקה, ממוקדת במפתחים. בין אם אתה אנליסט נתונים המשלים דוחות רבעוניים, צוות פיננסים שעוקב אחרי שינויים בתקציב, או מהנדס תוכנה שמטמיע יכולות diff למסלול נתונים רחב יותר, API זה נועד לפגוש אותך במקום שאתה נמצא ולסלק את חוסר הוודאות בזיהוי השינויים במגוון רחב של פורמטים של גיליונות. בלב API ההשוואה עומד מודל פשוט אך חזק: אתה מספק שני קובצי מקור — בין אם הם מגיעים מ-Apple Numbers, ייצוא CSV/TSV, או חבילת Excel הנפוצה (.xlsx, .xls) — והשירות מחזיר קובץ תוצאה יחיד שמדגיש כל הוספה, מחיקה ושינוי עם סמנים חזותיים ברורים. החשיבות על הבהירות איננה תוספת אחרי‑הדבר; כל שינוי מוסתר בצורה שמדמה קונבנציות טבעיות של גיליונות (רקעי תאים בצבע, בועות הערה, וסמנים של שורות/עמודות) כך שהמשתמש הקצה יכול לפתוח את התוצאה באפליקציה המועדפת עליו ולהבין מיד מה השתנה. מעבר ל‑diff הבסיסי, ה‑API גם משמר פורמט מקורי, נוסחאות וסוגי נתונים, ומבטיח שהתוצאה אינה רק דוח טקסט פשוט אלא חוברת עבודה מלאה פונקציונלית המוכנה לניתוח נוסף או להפצה. האבטחה והביצועים מוטמעים בכל בקשה: כל העברות הקבצים נעשות דרך TLS 1.3, הקבצים מעובדים במכולות מבודדות עם מגבלות זיכרון קפדניות, והתוצאות מוחזרות בדרך כלל בפחות שנייה לקבצים עד 10 MB, והן מתרחבות בחינניות עבור מערכי נתונים גדולים יותר באמצעות זרימה בחלקים. התיעוד שאתה קורא כעת מאורגן כדי לקבל אותך מורץ בתוך דקות — מתחיל באימות, עובר דרך בניית בקשה, ומסתיים בתבניות מומלצות לטיפול בשגיאות, פגינציה, ושילוב webhook. לאורך כל הדרך תמצא קטעי קוד ב‑Python, JavaScript, Java, ו‑C#, המדגימים כיצד שורה אחת של קוד יכולה להפעיל השוואה מלאה, וכן סביבת ארגז חול שבה תוכל להתנסות בקבצים אמיתיים ללא צורך לעזוב את הדפדפן. בסיום מדריך זה, תהיה לך הבנה חזקה כיצד לשלב השוואת גיליונות מדויקת, מהימנה, בתהליך עבודה כלשהו, להפחית זמן בדיקה ידני, ולאפשר לבעלי עניין יומן שינוי שקוף וניתן לביקורת — וכל זאת תוך ניצול API שהופך להיות בטוח ומהיר כפי שהוא פשוט לשימוש.

תכונות עיקריות

API ההשוואה מציג סט רחב של תכונות המתמודדות עם נקודות הכאב הנפוצות ביותר בעת התאמת נתוני גיליונות מפלטפורמות מגוונות. בראש ובראשונה, ה‑API תומך ברשימה מקיפה של פורמטים: Apple Numbers (.numbers), קבצי טקסט מופרדים (CSV, TSV), Excel ישן (.xls), ו‑Excel מודרני (.xlsx). זה מבטל את הצורך בכלי קדם‑המרה, ומאפשר להזין את הקבצים המקוריים ישירות לשירות. מנוע ה‑diff פועל ברמת התא, מגלה שינויי ערכים, נוסחאות ואף תכונות פורמט כגון סגנון גופן, צללי תאים, וכללי אימות נתונים; כל סטייה מודגשת בבירור בחוברת העבודה המתקבלת באמצעות ערכות צבעים שניתן להתאים, ומקלה על ביקורת של משתמשים לא‑טכניים להבין את הפלט. עבור קבוצות נתונים בקנה מידה גדול, ה‑API מציע מצב השוואה מצטבר, המאפשר להשוות רק את השורות שנוספו או שונו מאז בסיס קודמת, ובכך לחסוך זמן עיבוד ורוחב פס. בנוסף, ניתן לבקש סיכום JSON מובנה של השינויים בנוסף לקובץ ה‑diff החזותי, המאפשר אוטומציה בת downstream כגון הפעלת התראות, עדכון לוחות מחוונים, או אינטגרציה עם מערכות שליטת גרסאות. תכונות האבטחה כוללות אימות באמצעות טוקן נושא OAuth 2.0, מפתחות API עם היקף, ו‑whitelisting של IP כאופציה, בעוד שהנתונים במנוחה מוצפנים ב‑AES‑256. השירות עומד גם בתקני GDPR ו‑CCPA, ומספק לך ביטחון בעבודה עם מידע אישי או פיננסי רגיש. מבחינת ביצועים, ה‑API נבנה לתגובה מהירה; הודות להרחבה אופקית ואלגוריתמי diff בזיכרון, רוב ההשוואות משולמות בפחות שנייה עבור חוברות עבודה בגודל רגיל, ויש תמיכה בעיבוד אסינכרוני באמצעות webhooks לקבצים מעל 50 MB. ולבסוף, חוויית המפתח היא בעדיפות עליונה: מפרטי OpenAPI מקיפים, SDK‑ים שנוצרים אוטומטית, קודי שגיאה מפורטים, וכותרות קצב‑הגבלה בזמן אמת מאפשרות אינטגרציה עם חיכוך מינימלי, והקונסולה של ארגז החול שלנו והרפרטואר הרחב של דוגמאות מציגים יישומים של מיטב הפרקטיקות לעיבוד במצב מאצ׳, pipelines CI/CD, ופונקציות ללא שרת. בקיצור, API ההשוואה מספק השוואת גיליונות מהירה, מאובטחת וידידותית למפתחים, שמאפשרת לך לאתר שינויים עם קריאה אחת פשוטה – ללא תלות בפורמט, גודל או מורכבות הנתונים שאתה מעבד.

מסמכים

פרמטרים

format: פורמט קובץ פלט נתמך.
UploadFileRequest.OperationId: זהו מזהה פעולה
UploadFileRequest.Files: אלו קבצים שעליך להעלות לשירותינו המקוונים, אתה יכול להכין את הנתונים כפי שנוח לך אך עליהם לעמוד בתקן של קובץ קלט HTML.

השתמש בנקודת הקצה

שלח בקשה הכוללת את הקבצים ואת אסימון הגישה API ההשוואה

curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.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'
תקבל את הקובץ ואתה יכול להשתמש בו או פשוט להעביר אותו לשלב הבא בתהליך העבודה שלך.