المقارنة
مرحبًا بكم في مركز الوثائق الرسمي لواجهة برمجة التطبيقات المقارنة (Comparison API)، وهو حل مُصمم خصيصًا يحول مهمة التحكم في إصدارات جداول البيانات المرهقة غالبًا إلى سير عمل مُبسّط يركز على المطورين. سواءً كنت محلل بيانات يوافق على التقارير ربع السنوية، أو فريق مالية يتعقب تعديلات الميزانية، أو مهندس برمجيات يدمج قدرات المقارنة في خط أنابيب بيانات أكبر، تم تصميم هذه الواجهة لتلائم احتياجاتك وتزيل التخمين عند اكتشاف التغييرات عبر مجموعة واسعة من صيغ جداول البيانات. في جوهرها، تتبع واجهة المقارنة نموذجًا بسيطًا لكنه قوي: تقوم بتزويدها بملفين مصدرين—سواء كانا من Apple Numbers أو تصدير CSV/TSV أو مجموعة Excel الشاملة (.xlsx، .xls)—وتُعيد الخدمة ملف نتيجة واحد يبرز كل إضافة وحذف وتعديل بإشارات بصرية واضحة كالكريستال. التركيز على الوضوح ليس فكرة لاحقة؛ كل اختلاف يتم تعليقه بطريقة تحاكي conventions جداول البيانات الأصلية (خلفيات خلايا ملونة، فقاعات تعليقات، وعلامات صف/عمود) بحيث يمكن للمستخدمين النهائيين فتح النتيجة في التطبيق المفضل لديهم وفهم ما تغير فورًا. بالإضافة إلى المقارنة الأساسية، يبقي الAPI على التنسيق الأصلي، الصيغ، وأنواع البيانات، مما يضمن أن المخرجات ليست مجرد تقرير نصي بل مصنف عمل كامل الوظائف جاهز للمزيد من التحليل أو التوزيع. الأمان والأداء مدمجان في كل طلب: جميع نقلات الملفات تتم عبر TLS 1.3، وتُعالج الملفات في حاويات معزولة مع حدود صارمة للذاكرة، وتُعاد النتائج عادةً في أقل من ثانية للملفات حتى 10 ميغابايت، مع توسّع سلس لمجموعات بيانات أكبر عبر البث المتقطّع. الوثائق التي تقرأها الآن منظمة لتجعلك تبدأ وتعمل في دقائق—بدءًا بالمصادقة، مرورًا بإنشاء الطلب، وصولاً إلى أنماط الممارسات المثلى لمعالجة الأخطاء، الترميز الصفحي، وتكامل الويب هوك. طوال الوقت، ستجد مقتطفات شفرة بلغة Python، JavaScript، Java، وC#، توضح كيف يمكن لسطر شفرة واحد أن يُطلق مقارنة كاملة، بالإضافة إلى بيئة sandbox حيث يمكنك تجربة ملفات حقيقية دون مغادرة المتصفح. في نهاية هذا الدليل، ستحصل على فهم قوي لكيفية دمج مقارنة جداول بيانات موثوقة وعالية الدقة في أي سير عمل، وتقليل وقت المراجعة اليدوية، وتمكين أصحاب المصلحة بسجلات تغييرات شفافة وقابلة للتدقيق— كل ذلك مع الاستفادة من واجهة برمجة تطبيقات آمنة وسريعة وسهلة الاستخدام.
الميزات الرئيسية
تفتخر واجهة برمجة التطبيقات المقارنة (Comparison API) بمجموعة ميزات واسعة تعالج أكثر نقاط الألم شيوعًا التي تُواجه عند توافق بيانات جداول البيانات عبر منصات متنوعة. أولا وقبل كل شيء، تدعم الAPI قائمة شاملة من صيغ الملفات: Apple Numbers (.numbers)، ملفات النص العادي المفصولة (CSV، TSV)، إكسل القديم (.xls)، وإكسل الحديث (.xlsx). هذا يُزيل الحاجة إلى أدوات التحويل المسبق، مما يسمح لك بإدخال الملفات الأصلية مباشرةً إلى الخدمة. يعمل محرك الفرق على مستوى الخلية، مكتشفًا تغييرات القيم والصيغ وحتى خصائص التنسيق مثل نمط الخط، تظليل الخلية، وقواعد التحقق من البيانات؛ كل اختلاف يُبرز بوضوح في المصنف الناتج باستخدام أنظمة ألوان قابلة للتخصيص، مما يسهل على المراجع غير التقني تفسير النتيجة. بالنسبة لمجموعات البيانات الضخمة، تقدم الAPI وضع المقارنة التincremental، مما يتيح لك مقارنة الصفوف التي تمت إضافتها أو تعديلها فقط منذ النسخة الأساسية السابقة، وبالتالي تقليل وقت المعالجة وعرض النطاق الترددي. بالإضافة إلى ذلك، يمكنك طلب ملخص JSON مُهيكل للتغييرات إلى جانب ملف الفرق البصري، مما يُمكّن الأتمتة اللاحقة مثل تشغيل التنبيهات، تحديث لوحات التحكم، أو تغذية التغييرات إلى أنظمة التحكم في الإصدارات. تشمل ميزات الأمان توثيق رمز الحامل OAuth 2.0، مفاتيح API مقيّدة النطاق، وإمكانية وضع القوائم البيضاء لعناوين IP، بينما يُشفَّر البيانات المستقرة بـ AES‑256. تتبع الخدمة أيضًا معايير الامتثال لـ GDPR و CCPA، مما يمنحك الثقة عند التعامل مع معلومات شخصية أو مالية حساسة. من حيث الأداء، صُمّمت الAPI لتقليل الكمون؛ بفضل التوسع الأفقي وخوارزميات الفرق في الذاكرة، تُكمل معظم المقارنات في أقل من ثانية للدفاتر ذات الحجم القياسي، مع دعم المعالجة اللاإزامية عبر الويب هوك للملفات التي تتجاوز 50 ميغابايت. أخيرًا، تجربة المطور هي أولوية قصوى: مواصفات OpenAPI شاملة، SDKs مُولدة تلقائيًا، رموز أخطاء مفصلة، ورؤوس حدود المعدل في الوقت الفعلي تمكّنك من دمج الAPI بأقل قدر من الاحتكاك، بينما تُظهر وحدة التحكم sandbox ومستودع العينات الواسع تطبيقات أفضل الممارسات للمعالجة الدُفعية، خطوط CI/CD، والوظائف الخالية من الخوادم. باختصار، تُقدِّم Comparison 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' -
ستستجيب الخدمة برابط تنزيل للملف المعالج، في هذا المثال هو:
{ "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' - ستستلم الملف ويمكنك إما استخدامه أو إرساله إلى الخطوة التالية في سير عملك.
