API टोकन | Procurize.AI#

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

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

अवलोकन#

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

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

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

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

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

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

API टोकन पैनल

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

नया टोकन जनरेट करना#

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

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

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

नया 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-*` हेडर देखें।