مقایسه
به مرکز مستندات رسمی API مقایسه خوش آمدید، راهحلی هدفمند که کار خستهکننده کنترل نسخههای صفحات گسترده را به یک جریان کاری متمرکز بر توسعهدهندگان تبدیل میکند. چه شما یک تحلیلگر داده باشید که گزارشهای فصلی را هماهنگ میکند، تیم مالی که بازنگریهای بودجه را دنبال میکند، یا مهندسی نرمافزار که قابلیتهای diff را در یک خط لوله دادهای بزرگتر جاسازی میکند، این API طوری طراحی شده است که در هر مرحلهای که هستید به شما کمک کند و حدس زدن تغییرات در انواع فرمتهای صفحه گسترده را از بین ببرد. در هسته این API مدل ساده ولی قدرتمندی وجود دارد: دو فایل منبع را فراهم میکنید — چه از Apple Numbers، یک خروجی CSV/TSV یا مجموعه گسترده Excel (.xlsx, .xls) — و سرویس یک فایل نتیجه واحد برمیگرداند که هر افزودن، حذف و اصلاح را با نشانههای بصری شفاف نشان میدهد. تأکید بر شفافیت پس از فکر نیست؛ هر تفاوت بهگونهای که با استانداردهای بومی صفحه گسترده مطابقت داشته باشد (پسزمینه سلولهای رنگی، حبابهای نظر و نشانگرهای ردیف/ستون) حاشیهنویسی میشود تا کاربران نهایی بتوانند نتیجه را در برنامه مورد علاقهشان باز کنند و فوراً درک کنند چه چیزی تغییر کرده است. علاوه بر diff پایه، API قالببندی اصلی، فرمولها و انواع دادهها را حفظ میکند، بهطوری که خروجی فقط یک گزارش متن ساده نیست بلکه یک کتابکار کاملاً عملی است که میتوان آن را برای تجزیه و تحلیل یا توزیع بیشتر به کار برد. امنیت و عملکرد در هر درخواست تعبیه شدهاند: تمام انتقالهای فایل از طریق TLS 1.3 انجام میشود، فایلها در کانتینرهای ایزوله با محدودیتهای حافظه سخت پردازش میشوند، و نتایج معمولاً کمتر از یک ثانیه برای فایلهای تا ۱۰ مگابایت بازگردانده میشود، در حالی که برای مجموعهدادههای بزرگتر با استریمکردن قطعهقطعه مقیاسپذیر است. مستنداتی که اکنون میخوانید به گونهای سازماندهی شدهاند که شما را در چند دقیقه راهاندازی کنند — از اعتبارسنجی، عبور از ساختار درخواست و در نهایت الگوهای بهترین شیوه برای مدیریت خطا، صفحهبندی و ادغام webhook. در طول این راهنما، قطعههای کد به زبانهای Python، JavaScript، Java و C# خواهید یافت که نشان میدهند چگونه یک خط کد میتواند یک مقایسه کامل را فعال کند، همچنین محیطی sandbox که میتوانید با فایلهای واقعی بدون ترک مرورگر خود آزمایش کنید. در پایان این راهنما، درک جامعی از چگونگی ادغام مقایسه دقیق و قابل اطمینان صفحات گسترده در هر گردش کاری، کاهش زمان بازبینی دستی و ارائه لاگهای تغییر شفاف و قابل حسابرسی خواهید داشت — تمام اینها در حالی که از API ایمن، سریع و آساناستفاده بهره میبرید.
ویژگیهای اصلی
API مقایسه دارای مجموعهای گسترده از ویژگیها است که رایجترین نکات دردناک در توافق دادههای صفحات گسترده در سکوهای متنوع را برطرف میکند. مهمترین نکته، پشتیبانی از لیست کاملی از فرمتهای فایل: Apple Numbers (.numbers)، فایلهای متنی با جداساز (CSV, TSV)، Excel قدیمی (.xls) و Excel مدرن (.xlsx). این امر نیاز به ابزارهای پیشتبدیل را از بین میبرد و اجازه میدهد فایلهای اصلی را مستقیماً به سرویس بدهید. موتور diff در سطح سلول کار میکند و تغییرات در مقادیر، فرمولها و حتی ویژگیهای قالببندی مثل سبک قلم، سایهگذاری سلول و قوانین اعتبارسنجی داده را شناسایی میکند؛ هر اختلاف بهوضوح در کتابکار نتیجه با طرح رنگی قابل تنظیم برجسته میشود، بهطوری که مرورکنندگان غیر فنی بتوانند خروجی را تفسیر کنند. برای مجموعهدادههای بزرگ، API حالت مقایسه افزایشی را ارائه میدهد که فقط ردیفهای افزوده یا تغییر یافته از یک پایه قبلی را مقایسه میکند و زمان پردازش و پهنای باند شبکه را کاهش میدهد. علاوه بر این میتوانید یک خلاصه ساختار یافتهٔ JSON از تغییرات درخواست کنید؛ این امکان خودکارسازیهای بعدی مانند ایجاد هشدار، بهروزرسانی داشبورد یا تزریق تغییرات به سیستمهای کنترل نسخه را فراهم میکند. ویژگیهای امنیتی شامل احراز هویت توکن OAuth 2.0، کلیدهای API با محدوده، و لیست سفید آیپی اختیاری است؛ دادههای استراحت با AES‑256 رمزگذاری میشوند. سرویس همچنین با استانداردهای GDPR و CCPA مطابقت دارد، بنابراین هنگام کار با اطلاعات حساس شخصی یا مالی اطمینان دارید. از نظر عملکرد، API برای تأخیر کم طراحی شده؛ با مقیاسپذیری افقی و الگوریتمهای diff در حافظه، اکثر مقایسهها در کمتر از یک ثانیه برای کتابکارهای اندازهٔ استاندارد تکمیل میشوند، و برای فایلهای بیش از ۵۰ مگابایت پردازش ناهمزمان از طریق webhookها پشتیبانی میشود. در نهایت، تجربهٔ توسعهدهنده در اولویت است: مشخصات کامل OpenAPI، SDKهای خودکار تولید شده، کدهای خطای دقیق و سرصفحههای نرخمحدودیت زمان واقعی به شما امکان میدهند با حداقل اصطکاک API را یکپارچه کنید؛ همچنین کنسول sandbox و مخزن نمونههای گسترده الگوهای بهترین شیوه برای پردازش دستهای، خطوط CI/CD و توابع سرورلس را نشان میدهند. بهعبارت دیگر، API مقایسه قابلیتهای سریع، امن و توسعهدهنده‑دوست diff صفحات گسترده را فراهم میکند که با یک فراخوانی ساده، تغییرات را در هر قالب، اندازه یا پیچیدگی دادهها شناسایی میکند.
اسناد
پارامترها
- 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' - فایل را دریافت خواهید کرد و میتوانید یا از آن استفاده کنید یا به سادگی به مرحله بعدی گردش کار خود ارسال کنید.
