प्रमाणीकरण
हमारे API के एंडपॉइंट्स का उपयोग शुरू करने के लिए, आपको पहले प्रमाणीकरण करना होगा। यह मार्गदर्शिका Sheetize Cloud प्लेटफ़ॉर्म के साथ प्रमाणीकरण क्रेडेंशियल्स प्राप्त करने और उपयोग करने के तरीकों को समझाती है।
मुख्य विशेषताएँ
Sheetize Cloud का प्रमाणीकरण प्रवाह आपके डेटा की सुरक्षा के लिए और यह सुनिश्चित करने के लिए डिज़ाइन किया गया है कि केवल अधिकृत उपयोगकर्ता ही फ़ाइलें अपलोड कर सकें और हमारी सेवाओं को कॉल कर सकें। यह प्रदान करता है:
- Secure, token-based access that can be revoked at any time.
- Support for both machine-to-machine and user-driven scenarios.
- Granular scopes that let you limit what a token can do.
कैसे उपयोग करें
एक एप्लिकेशन बनाएं
- जाएँ डैशबोर्ड
- लॉग इन करने के बाद, बाएँ नेविगेशन बार में **Applications** मेनू आइटम पर क्लिक करें।
- **Create New Application** दबाएँ ताकि एप्लिकेशन निर्माण फ़ॉर्म खुल सके।
- *Application Details* सेक्शन में, अपने एप्लिकेशन के लिए एक वर्णनात्मक नाम और संक्षिप्त विवरण दर्ज करें।
- नई एप्लिकेशन को सहेजने के लिए **Save** बटन पर क्लिक करें।
- एप्लिकेशन्स की सूची में, अभी बनाई गई एप्लिकेशन को खोजें और उसके नाम पर क्लिक करें।
- *Client Credentials* पैनल में आप **Client ID** और **Client Secret** देखेंगे - इन मानों को सुरक्षित रखें; इनकी आवश्यकता एक्सेस टोकन प्राप्त करने के लिए होगी।
एक एक्सेस टोकन प्राप्त करें
-
एक अनुरोध करें Authenticator एंडपॉइंट
https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret - क्रियान्वयन के बाद आपको टोकन प्राप्त होगा, कृपया इसे बाद में उपयोग के लिए सहेजें
एंडपॉइंट्स का उपयोग करें
- वह API चुनें जिसे आप कॉल करना चाहते हैं। इस उदाहरण में हम Conversion सेवा को दर्शाते हैं, जो स्प्रेडशीट फ़ाइलों को PDF फ़ॉर्मेट में बदलती है।
-
फ़ाइलें और एक्सेस टोकन शामिल करते हुए एक अनुरोध भेजें Conversion API
curl -X 'POST' \ 'https://api.sheetize.cloud/conversion/to-pdf' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer The_Secret_Access_Token \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@TestFile.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
सेवा उत्पन्न PDF के लिए एक डाउनलोड URL के साथ प्रतिक्रिया करेगी, इस उदाहरण में यह है:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 } -
फ़ाइल नाम और फ़ोल्डर नाम शामिल करते हुए एक अनुरोध भेजें Download API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - आपको फ़ाइल प्राप्त होगी और आप इसे उपयोग कर सकते हैं या बस अपने वर्कफ़्लो के अगले चरण में अग्रेषित कर सकते हैं।