सभी गाइड

टीम और प्रशासन

API टोकन

प्रोग्राम, स्क्रिप्ट और ऑटोमेशन से API टोकन के साथ Sealed Print का प्रबंधन करवाएँ।

API टोकन किसी प्रोग्राम को Sealed Print REST API तक पहुँच देता है, उदाहरण के लिए किसी स्क्रिप्ट से जॉब पर नज़र रखने, गंतव्यों का प्रबंधन करने या कतार पढ़ने के लिए। टोकन उसे बनाने वाले व्यक्ति की ओर से, अधिकतम उसकी अनुमतियों के साथ, और केवल उसी संगठन में काम करता है जहाँ उसे बनाया गया था। API संदर्भ हर एंडपॉइंट का उदाहरणों के साथ वर्णन करता है।

पूर्वापेक्षाएँ

  • हर सदस्य ब्राउज़र सत्र में टोकन बना सकता है। एडमिन संगठन के सभी टोकन देख और निरस्त कर सकते हैं।
  • टोकन Sealed Print का प्रबंधन और नियंत्रण करते हैं: जॉब, स्रोत, गंतव्य और सेटिंग्स। वे जॉब सबमिट नहीं कर सकते; इसके बजाय प्रोग्राम किसी API एंडपॉइंट पर दस्तावेज़ भेजते हैं।
  • हर प्लान में शामिल।

एक बार का सेटअप

  1. सेटिंग्स → API टोकन पर जाएँ और नया टोकन चुनें।
  2. एक नाम दर्ज करें जो बताए कि टोकन किस काम के लिए है, उदाहरण के लिए "लेखा इनवॉइस निर्यात"।
  3. अनुमतियाँ चुनें: उपयोगकर्ता (आपके अपने स्रोत, गंतव्य और जॉब), एडमिन या स्वामी, अधिकतम आपकी अपनी भूमिका तक।
  4. समाप्ति चुनें: 7, 30 या 90 दिन, 1 वर्ष, कोई अपनी तारीख़, या कोई समाप्ति नहीं।
  5. बनाएँ चुनें और टोकन कॉपी करें। टोकन केवल अभी दिखाया जाता है; इसे सुरक्षित रूप से संग्रहीत करें, उदाहरण के लिए पासवर्ड मैनेजर में।

हर अनुरोध के साथ टोकन को हेडर Authorization: Bearer sp_api_… में भेजें। अपने जॉब की सूची देखने के लिए:

curl "https://www.sealedprint.com/api/jobs" \
  -H "Authorization: Bearer sp_api_…"

इसी हेडर के साथ आपका प्रोग्राम किसी जॉब पर नज़र रखता है (GET /api/jobs/{id}), उसे और गंतव्यों पर भेजता है या उसे रद्द करता है।

हर बार

  • टोकन सूची में अंतिम उपयोग दिखाता है कि कोई प्रोग्राम अभी भी टोकन का उपयोग कर रहा है या नहीं।
  • नाम बदलें नाम बदलता है; रोल करें उसी टोकन के लिए एक नया सीक्रेट जारी करता है (पुराना तुरंत काम करना बंद कर देता है, नाम, अनुमतियाँ और समाप्ति वही रहती हैं); निरस्त करें उसे स्थायी रूप से समाप्त करता है।
  • समाप्त और निरस्त दिखाएँ उन टोकन की सूची दिखाता है जो अब काम नहीं करते।

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

  • HTTP 401: टोकन मौजूद नहीं है, गलत है, समाप्त हो गया है या निरस्त कर दिया गया है।
  • HTTP 403: टोकन की अनुमतियाँ इस कार्रवाई की अनुमति नहीं देतीं। टोकन से जॉब सबमिट करना संभव नहीं है (कोड api_endpoint_required); दस्तावेज़ किसी API एंडपॉइंट पर भेजें।
  • कोई टोकन अचानक काम करना बंद कर देता है: जब टोकन बनाने वाला व्यक्ति संगठन छोड़ देता है, तो टोकन अमान्य हो जाते हैं। किसी दूसरे सदस्य के साथ नया टोकन बनाएँ।
  • टोकन किसी ऐसी जगह कॉपी हो गया जहाँ उसे नहीं होना चाहिए: तुरंत रोल करें या निरस्त करें चुनें।

आगे क्या