API टोकन | Procurize.AI#

सुरक्षित प्रोग्रामेटिक एक्सेस के लिए अपने Procurize.AI कार्यस्थल में API टोकन उत्पन्न, प्रबंधित और उपयोग करें।

लागू होता है: Procurize.AI डैशबोर्ड → सेटिंग्स → टोकन
उपलब्धता: बिजनेस और एंटरप्राइज़ प्लान्स
आवश्यक भूमिका: सुरक्षा प्रबंधक, संपादक, व्यवस्थापक या मेंटेनर

अवलोकन#

API टोकन Procurize.AI प्लेटफ़ॉर्म तक सुरक्षित, प्रोग्रामेटिक एक्सेस प्रदान करते हैं। आप टोकन का उपयोग करके Procurize.AI को अपने आंतरिक सिस्टम्स के साथ एकीकृत कर सकते हैं, वर्कफ़्लो को स्वचालित कर सकते हैं, या प्लेटफ़ॉर्म के ऊपर कस्टम एप्लिकेशन बना सकते हैं।

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

टोकन उस उपयोगकर्ता की सभी अनुमतियों को विरासत में लेते हैं जिसने उन्हें बनाया
टोकन संगठन‑स्तरीय होते हैं – API कॉल में org निर्दिष्ट करने की आवश्यकता नहीं
अनिश्चित संख्या में टोकन उत्पन्न किए जा सकते हैं
टोकन में समाप्ति तिथि हो सकती है या कभी समाप्त न हो (अनलिमिटेड वैधता)
टोकन को निष्क्रिय किया जा सकता है और आवश्यकता पड़ने पर पुनः सक्रिय किया जा सकता है

🔒 सुरक्षा नोट: Procurize.AI टोकन मान को सहेजता नहीं है – केवल उसका हैश रखता है। उत्पन्न करने के बाद आपको टोकन को तुरंत कॉपी और सुरक्षित रूप से संग्रहीत करना होगा। यह फिर से नहीं दिखेगा।

टोकन प्रबंधन पैनल तक पहुँच#

डैशबोर्ड → API टोकन पृष्ठ पर जाएँ।
टोकन प्रबंधन पैनल वर्तमान संगठन से जुड़े आपके व्यक्तिगत टोकन दिखाता है।

API टोकन पृष्ठ

आवश्यक अनुमति: केवल सुरक्षा प्रबंधक, संपादक, व्यवस्थापक या मेंटेनर भूमिकाओं वाले उपयोगकर्ता इस पैनल तक पहुँच सकते हैं। विस्तृत भूमिका परिभाषाओं के लिए देखें अनुमतियों का अवलोकन।

नया टोकन उत्पन्न करना#

टोकन के उद्देश्य को पहचानने के लिए नाम दर्ज करें।
समाप्ति अवधि चुनें:
- 1 महीना
- 3 महीने
- 1 वर्ष
- कोई समाप्ति नहीं (अनलिमिटेड वैधता)
“Generate” पर क्लिक करें।

महत्वपूर्ण – टोकन को तुरंत कॉपी करें#

उत्पन्न करने के बाद टोकन मान एक बार ही दिखाया जाता है – इसे कॉपी करें और सुरक्षित रूप से संग्रहीत करें (जैसे पासवर्ड मैनेजर या पर्यावरण चर में)।

नया API टोकन

⚠️ आप टोकन मान को फिर से नहीं देख पाएँगे। Procurize.AI केवल सत्यापन के लिए सुरक्षित हैश रखता है। यदि आप टोकन खो देते हैं, तो उसे रद्द करें और नया टोकन उत्पन्न करें।

मौजूदा टोकनों का प्रबंधन#

टोकन पैनल सभी उत्पन्न टोकनों की सूची दिखाता है, जिसमें शामिल हैं:

नाम
सफ़िक्स
निर्माण तिथि
समाप्ति तिथि (या “-”)
स्थिति: सक्रिय या निष्क्रिय

टोकन को निष्क्रिय / पुनः सक्रिय करना#

निष्क्रिय – टोकन को अस्थायी रूप से बंद कर देता है। आवश्यकता पड़ने पर बाद में पुनः सक्रिय किया जा सकता है।
पुनः सक्रिय – पहले निष्क्रिय किए गए टोकन को फिर से सक्रिय स्थिति में लाता है।

💡 निष्क्रिय करना उन एकीकरणों को अस्थायी रूप से रोकने में उपयोगी है, बिना टोकन को हटाए।

टोकन को रद्द करना#

रद्द – टोकन को स्थायी रूप से हटा देता है। यह कार्रवाई वापस नहीं ली जा सकती।
यदि आप टोकन खो देते हैं, तो उसे तुरंत रद्द करें और नया टोकन उत्पन्न करें।

API टोकन का उपयोग#

बेस URL और प्रमाणीकरण#

पैरामीटर	मान
बेस URL	`https://api.procurize.com`
प्रमाणीकरण विधि	हेडर के माध्यम से API कुंजी
हेडर	`X-API-Key: <YOUR_API_TOKEN>`

उदाहरण अनुरोध (cURL)#

curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"

🧠 संगठन ID की आवश्यकता नहीं – टोकन आपके संगठन से बंधा है, इसलिए API स्वचालित रूप से संदर्भ निर्धारित कर लेता है।

महत्वपूर्ण सुरक्षा एवं उपयोग नियम#

नियम	विवरण
टोकन अनुमतियाँ	टोकन के पास वही अनुमतियाँ होती हैं जो इसे बनाने वाले उपयोगकर्ता की होती हैं। यदि उपयोगकर्ता की भूमिका बदलती है, तो टोकन की अनुमतियाँ भी उसी अनुसार अपडेट होती हैं।
संगठन बंधन	टोकन निर्माता के संगठन से बंधे होते हैं। आप एक टोकन को कई संगठनों में उपयोग नहीं कर सकते।
टोकन दृश्यता	टोकन मान केवल एक बार दिखाया जाता है। तुरंत इसे संग्रहीत करें। Procurize.AI केवल हैश रखता है।
समाप्त टोकन	समाप्त टोकन स्वचालित रूप से निष्क्रिय हो जाते हैं और उपयोग नहीं किए जा सकते। आवश्यकता पड़ने पर नया टोकन उत्पन्न करें।

समस्या निवारण#

समस्या	समाधान
“Invalid API key” त्रुटि	सुनिश्चित करें कि टोकन सही ढंग से कॉपी किया गया है (कोई अतिरिक्त स्पेस नहीं)। जाँचें कि टोकन अभी भी सक्रिय है और समाप्त नहीं हुआ है।
भूमिका परिवर्तन के बाद टोकन काम नहीं कर रहा	टोकन की अनुमतियाँ उपयोगकर्ता की वर्तमान भूमिका के अनुसार अपडेट हो जाती हैं। यदि उपयोगकर्ता ने अनुमतियाँ खो दी हैं, तो टोकन भी वही खो देगा।
टोकन खो गया	खोए हुए टोकन को रद्द करें और नया टोकन उत्पन्न करें।
रेट लिमिटिंग	आपके प्लान के आधार पर API रेट लिमिट लागू होते हैं। प्रतिक्रिया में `X-RateLimit-*` हेडर देखें।