तुलना

Comparison API के आधिकारिक दस्तावेज़ केंद्र में आपका स्वागत है, एक विशिष्ट समाधान जो अक्सर थकाऊ स्प्रेडशीट संस्करण नियंत्रण कार्य को एक सुगम, डेवलपर‑केंद्रित वर्कफ़्लो में बदल देता है। चाहे आप तिमाही रिपोर्टों को मिलान करने वाले डेटा विश्लेषक हों, बजट संशोधनों को ट्रैक करने वाली वित्त टीम हों, या बड़े डेटा पाइपलाइन में डिफ़ क्षमताओं को एम्बेड करने वाले सॉफ़्टवेयर इंजीनियर हों, यह API आपको जहाँ आप हैं वहाँ से मदद करने और विभिन्न स्प्रेडशीट फ़ॉर्मेट में बदलावों को पहचानने का काम आसान बनाने के लिए डिज़ाइन किया गया है। मुख्य रूप से, Comparison API एक सरल लेकिन शक्तिशाली मॉडल का अनुसरण करता है: आप दो स्रोत फ़ाइलें प्रदान करते हैं—चाहे वे Apple Numbers, CSV/TSV एक्सपोर्ट, या सामान्य Excel (.xlsx, .xls) सुइट से हों—और सेवा एकल परिणाम फ़ाइल लौटाती है जिसमें हर जोड़, हटाना और संशोधन स्पष्ट दृश्य संकेतकों के साथ हाइलाइट किए जाते हैं। स्पष्टता पर ज़ोर देना केवल बाद में नहीं आया; प्रत्येक अंतर को मूल स्प्रेडशीट सम्मेलनों (रंग‑कोडित सेल पृष्ठभूमि, टिप्पणी बबल, और पंक्ति/स्तंभ मार्कर) के समान स्वरूप में चिन्हित किया जाता है ताकि अंत‑उपयोगकर्ता परिणाम को अपनी पसंदीदा एप्लिकेशन में खोलकर तुरंत समझ सकें कि क्या बदल गया है। बुनियादी डिफ़ के अलावा, API मूल फ़ॉर्मेटिंग, सूत्र, और डेटा प्रकारों को भी संरक्षित रखता है, यह सुनिश्चित करते हुए कि आउटपुट सिर्फ साधारण टेक्स्ट रिपोर्ट नहीं बल्कि आगे के विश्लेषण या वितरण के लिए पूरी तरह कार्यात्मक वर्कबुक है। सुरक्षा और प्रदर्शन प्रत्येक अनुरोध में अंतर्निहित हैं: सभी फ़ाइल ट्रांसफ़र TLS 1.3 पर होते हैं, फ़ाइलें अलग‑अलग कंटेनरों में सख्त मेमोरी सीमाओं के साथ प्रोसेस की जाती हैं, और परिणाम आमतौर पर 10 MB तक की फ़ाइलों के लिए एक सेकंड से कम समय में लौटते हैं, जबकि बड़े डेटासेट के लिए चंक्ड स्ट्रीमिंग के माध्यम से सहज रूप से स्केल होते हैं। आप जिस दस्तावेज़ को पढ़ रहे हैं, वह मिनटों में शुरू करने के लिये व्यवस्थित किया गया है—पहले प्रमाणीकरण, फिर अनुरोध निर्माण, और अंत में त्रुटि प्रबंधन, पेजिनेशन, और वेबहुक इंटीग्रेशन के लिए सर्वोत्तम‑प्रैक्टिस पैटर्न। पूरे दस्तावेज़ में Python, JavaScript, Java, और C# में कोड स्निपेट्स मिलेंगे, जो दर्शाते हैं कि कैसे एक पंक्ति कोड पूरे तुलना को ट्रिगर कर सकता है, साथ ही एक सैंडबॉक्स वातावरण भी होगा जहाँ आप वास्तविक फ़ाइलों के साथ बिना ब्राउज़र छोड़े प्रयोग कर सकते हैं। इस गाइड के अंत तक, आपके पास किसी भी वर्कफ़्लो में विश्वसनीय, उच्च‑फिडेलिटी स्प्रेडशीट तुलना को एम्बेड करने, मैन्युअल समीक्षा समय कम करने, और हितधारकों को पारदर्शी, ऑडिटेबल परिवर्तन लॉग प्रदान करने की मजबूत समझ होगी—सभी एक ऐसी API के साथ जो सुरक्षित, तेज़, और उपयोग में आसान है।

मुख्य विशेषताएँ

Comparison API में विभिन्न प्लेटफ़ॉर्म पर स्प्रेडशीट डेटा को मिलाने के समय आम दर्द बिंदुओं को दूर करने के लिए व्यापक फीचर सेट शामिल है। सबसे पहले, API फ़ाइल फ़ॉर्मेट की एक व्यापक सूची को समर्थन देती है: Apple Numbers (.numbers), साधारण टेक्स्ट डिलिमिटेड फ़ाइलें (CSV, TSV), पुरानी Excel (.xls), और आधुनिक Excel (.xlsx)। इससे पूर्व‑कन्वर्ज़न टूल की आवश्यकता नहीं रहती, आप मूल फ़ाइलें सीधे सेवा में फीड कर सकते हैं। डिफ़ इंजन सेल स्तर पर काम करता है, मान, सूत्र, और यहाँ तक कि फ़ॉन्ट शैली, सेल शेडिंग, डेटा वैलिडेशन नियम जैसी फ़ॉर्मेटिंग विशेषताओं में परिवर्तन को भी पहचानता है; प्रत्येक अंतर को परिणाम वर्कबुक में अनुकूलन योग्य रंग योजनाओं के साथ स्पष्ट रूप से हाइलाइट किया जाता है, जिससे गैर‑तकनीकी समीक्षक भी आउटपुट को आसानी से समझ सकें। बड़े पैमाने के डेटा सेट के लिए, API इन्क्रीमेंटल तुलना मोड प्रदान करती है, जिससे आप सिर्फ उन पंक्तियों की तुलना कर सकते हैं जो पिछले बेसलाइन से जोड़ी या संशोधित हुई हैं, इस प्रकार प्रोसेसिंग समय और नेटवर्क बैंडविड्थ कम होती है। इसके अतिरिक्त, आप दृश्य डिफ़ फ़ाइल के साथ-साथ परिवर्तन का संरचित JSON सारांश भी अनुरोध कर सकते हैं, जिससे डाउनस्ट्रीम ऑटोमेशन जैसे अलर्ट ट्रिगर करना, डैशबोर्ड अपडेट करना, या परिवर्तन को संस्करण नियंत्रण प्रणाली में फ़ीड करना संभव होता है। सुरक्षा फीचर में OAuth 2.0 बेयरर टोकन प्रमाणीकरण, स्कोप्ड API कुंजियां, और वैकल्पिक IP‑व्हाइटलिस्टिंग शामिल हैं, जबकि डेटा एट रेस्ट AES‑256 से एन्क्रिप्टेड रहता है। सेवा GDPR और CCPA अनुपालन मानकों का पालन करती है, जिससे संवेदनशील व्यक्तिगत या वित्तीय जानकारी को संभालते समय आपको भरोसा मिलता है। प्रदर्शन की बात करें तो API कम लेटेंसी के लिए निर्मित है; क्षैतिज स्केलिंग और इन‑मेरी डिफ़ एल्गोरिदम के कारण अधिकांश तुलना मानक‑आकार की वर्कबुक के लिए एक सेकंड से कम समय में पूरी हो जाती है, और 50 MB से बड़ी फ़ाइलों के लिए वेबहुक के माध्यम से असिंक्रोनस प्रोसेसिंग भी समर्थित है। अंत में, डेवलपर अनुभव को प्राथमिकता दी गई है: व्यापक OpenAPI स्पेसिफिकेशन, ऑटो‑जनरेटेड SDKs, विस्तृत त्रुटि कोड, और रियल‑टाइम रेट‑लिमिट हेडर्स आपको न्यूनतम घर्षण के साथ API को इंटीग्रेट करने में सक्षम बनाते हैं, जबकि हमारा सैंडबॉक्स कंसोल और विस्तृत सैंपल रिपॉजिटरी बैच प्रोसेसिंग, 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'
सेवा प्रक्रिया की गई फ़ाइल के लिए एक डाउनलोड 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'
आप फ़ाइल प्राप्त करेंगे और आप इसे उपयोग कर सकते हैं या बस अपने वर्कफ़्लो के अगले चरण में अग्रेषित कर सकते हैं।