रूपांतरण
Metadata API एक विशेष रूप से निर्मित, डेवलपर‑मित्र सेवा है जो केवल एक HTTP अनुरोध से स्प्रेडशीट‑फ़ाइल मेटाडेटा पर पूर्ण नियंत्रण आपके हाथों में दे देती है। चाहे आप एक्सेल (.xlsx, .xls) जैसे क्लासिक ऑफिस फ़ॉर्मैट, CSV (.csv) और TSV (.tsv) जैसे सरल डिलिमिटेड फ़ाइलें, या Apple Numbers दस्तावेज़ (.numbers) से निपट रहे हों, API फ़ाइल पार्सिंग की जटिलताओं को अमूर्त बनाता है और आपको मिलीसेकंड में प्रमुख वर्णनात्मक गुण पढ़ने, जोड़ने या संशोधित करने की सुविधा देता है। कल्पना करें कि आप हजारों रिपोर्ट, शोध डेटा सेट या वित्तीय विवरणों को बैच‑प्रोसेस करके प्रत्येक फ़ाइल को लेखक जानकारी, शीर्षक, विषय, विवरण, कीवर्ड सूची और आपके एप्लिकेशन द्वारा परिभाषित कस्टम टैग संग्रह के एक स्थिर सेट से समृद्ध कर सकते हैं। यह स्तर का स्वचालन न केवल मैनुअल संपादन में अनगिनत घंटे बचाता है, बल्कि यह भी सुनिश्चित करता है कि आप क्लाइंट, सहयोगी या अभिलेखीय सिस्टम को जो भी फ़ाइल भेजते हैं, उसमें सही मेटाडेटा हो जो इंडेक्सिंग, अनुपालन और खोज क्षमता के लिए आवश्यक है। सेवा कच्चे फ़ाइल बाइट्स या क्लाउड‑होस्टेड दस्तावेज़ की URL को स्वीकार करती है, फिर अनुरोधित मेटाडेटा बदलाव लागू किए हुए नया, पूरी तरह से तैयार फ़ाइल वापस करती है, बिना मूल डेटा लेआउट या फ़ॉर्मूले बदले।
मुख्य विशेषताएँ
चूँकि API स्थितिहीन है, आप इसे आसानी से CI/CD पाइपलाइन, सर्वर‑साइड बैच जॉब्स या क्लाइंट‑साइड जावास्क्रिप्ट विजेट्स में एकीकृत कर सकते हैं, यह सुनिश्चित करते हुए कि वेब ऐप से प्रत्येक निर्यात या प्रत्येक आवधिक बैकअप में सही मूल सूचना समाहित हो। सुरक्षा अंतर्निहित है: सभी कॉल TLS के माध्यम से किए जाते हैं, पेलोड्स अंत‑से‑अंत एन्क्रिप्टेड होते हैं, और API API‑की या OAuth 2.0 प्रमाणीकरण का समर्थन करती है, जिससे आप केवल भरोसेमंद सेवाओं के लिए पहुँचा सीमित कर सकते हैं। अंतर्निहित इंजन प्रत्येक समर्थित फ़ॉर्मैट के लिए अत्यधिक अनुकूलित पार्सिंग लाइब्रेरीज़ का उपयोग करता है, जिससे सैकड़ों वर्कशीट वाले बड़े Excel वर्कबुक भी तेज़ी से प्रोसेस होते हैं; अधिकांश सामान्य अनुरोध 200 ms से कम समय में पूर्ण हो जाते हैं। व्यावहारिक रूप से, इसका अर्थ है कि आप अपने उत्पाद के भीतर एक सहज “Add Metadata” बटन बना सकते हैं जो फ़ाइल को सेवा को भेजता है, समृद्ध संस्करण प्राप्त करता है, और तुरंत डाउनलोड के लिये उपलब्ध कराता है—बिना उपयोगकर्ता को इंटरफ़ेस से बाहर निकले। API विस्तृत ऑपरेशन लॉग भी लौटाती है, जिससे डेवलपर्स प्रोग्रामेटिक रूप से सत्यापित कर सकते हैं कि अपेक्षित फ़ील्ड अपडेट हुए हैं, आवश्यकता पड़ने पर परिवर्तन वापस ले सकते हैं, या कस्टम टैग मानों के आधार पर आगे की प्रोसेसिंग कदम ट्रिगर कर सकते हैं। एक समान, भाषा‑अज्ञेय REST एंडपॉइंट प्रदान करके, Metadata API डेवलपर्स को कई फ़ॉर्मैट‑विशिष्ट लाइब्रेरीज़ को बनाए रखने की आवश्यकता समाप्त करती है, रख‑रखाव ओवरहेड घटाती है, और जैसे-जैसे नई स्प्रेडशीट मानक उभरते हैं, भविष्य‑सुरक्षित संगतता सुनिश्चित करती है। चाहे आप लाइसेंसिंग सूचना एम्बेड करने वाले SaaS विक्रेता हों, डेटा सेट को व्यवस्थित करने वाला शोध संस्थान, या दस्तावेज़ अनुपालन को स्वचालित करने वाला उद्यम, यह API एक सरल कॉल के साथ आपके फ़ाइलों को तेज़, सुरक्षित और स्केलेबल रूप से समृद्ध करने का तरीका प्रदान करती है।
दस्तावेज़
पैरामीटर
- AppRequest.Metadata: PropertyName और PropertyValue के साथ
- AppRequest.MetadataJson: यदि आप Metadata संरचना का उपयोग नहीं कर रहे हैं तो आपको JSON डेटा प्रकार का प्रयोग करना होगा।
- UploadFileRequest.OperationId: ये वे फ़ाइलें हैं जिन्हें आपको हमारी ऑनलाइन सेवाओं में अपलोड करना होगा; आप डेटा अपनी पसंद से तैयार कर सकते हैं, लेकिन यह HTML इनपुट फ़ाइल के मानक का पालन करना चाहिए।
- UploadFileRequest.Files: ये वे फ़ाइलें हैं जिन्हें आपको हमारी ऑनलाइन सेवाओं में अपलोड करना होगा; आप डेटा अपनी पसंद से तैयार कर सकते हैं, लेकिन यह HTML इनपुट फ़ाइल के मानक का पालन करना चाहिए।
-
फ़ाइलें और एक्सेस टोकन शामिल करते हुए एक अनुरोध भेजें Metadata API
curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
सेवा प्रोसेस किए गए फ़ाइल के लिए डाउनलोड URL के साथ उत्तर देगी, इस उदाहरण में यह है:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 } -
फ़ाइल नाम और फ़ोल्डर नाम शामिल करते हुए एक अनुरोध भेजें to Download API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - आपको फ़ाइल प्राप्त होगी और आप इसे उपयोग कर सकते हैं या बस अपने कार्य‑प्रवाह के अगले चरण में आगे भेज सकते हैं।
