API कुंजियाँ और प्रमाणीकरण

API कुंजी आपके अपने कोड, Posty5 SDK, n8n और AI असिस्टेंट को आपके Posty5 खाते के साथ काम करने देती है। यह पेज बताता है कि कुंजियाँ कैसे काम करती हैं, और अन्य डेवलपर पेज इसे दोहराने के बजाय यहाँ लिंक करते हैं।

डेवलपर खाता पाएँ

API कुंजियाँ डेवलपर खाते की सुविधा हैं। अपग्रेड करना मुफ़्त है और तुरंत लागू होता है। इससे आपका प्लान या आपके क्रेडिट नहीं बदलते।

Posty5 डैशबोर्ड में खाता सेटिंग्स खोलें और API कुंजियाँ चुनें।
डेवलपर में अपग्रेड करें चुनें। पेज फिर से लोड होगा और आपकी API कुंजियाँ तथा Posty5 से कनेक्ट करने के तरीके दिखाएगा।

डैशबोर्ड में API कुंजियाँ खोलें

कुंजी बनाएँ

API कुंजियाँ में, API कुंजी बनाएँ चुनें।
कुंजी को ऐसा नाम दें जो बताए कि इसका उपयोग कहाँ होता है, जैसे वेबसाइट संपर्क फ़ॉर्म। यह नाम केवल आपके लिए है।
इसका रिकॉर्ड का दायरा चुनें (नीचे समझाया गया है) और बनाएँ चुनें। नई कुंजी कॉपी बटन के साथ दिखाई देती है।

कुंजी केवल एक बार नहीं दिखाई जाती। सूची हर कुंजी को छिपाकर दिखाती है, और उसका कॉपी बटन जब भी ज़रूरत हो पूरी कुंजी फिर से कॉपी कर देता है। सूची में कुंजी की कार्रवाइयों से उसका नाम या रिकॉर्ड का दायरा बदलें।

हर अनुरोध के साथ कुंजी भेजें

Posty5 API को भेजे जाने वाले हर अनुरोध में कुंजी इस हेडर में भेजें —

API यहाँ उपलब्ध है,

किसी कुंजी की जाँच करने के लिए, उसका विवरण देने वाले रूट को कॉल करें। यह कुंजी, उसके मालिक, प्लान और खाते द्वारा खर्च किए जा सकने वाले क्रेडिट के साथ जवाब देता है। रद्द की गई या अज्ञात कुंजी को 401 मिलता है।

curl https://api.posty5.com/api/api-key/current \
  -H "X-API-Key: YOUR_API_KEY"

SDK और n8n नोड भी यही कुंजी लेते हैं।

क्लाइंट	कुंजी कहाँ डालें	और पढ़ें
JavaScript / TypeScript	`new HttpClient({ apiKey: "YOUR_API_KEY" })`	npm-sdk
.NET	`new Posty5Options { ApiKey = "YOUR_API_KEY" }`	dotnet-sdk
n8n	Posty5 API क्रेडेंशियल, उसके API Key फ़ील्ड में	n8n-nodes

तय करें कि कुंजी क्या देख सकती है

हर कुंजी का एक रिकॉर्ड का दायरा होता है। यह तय करता है कि कुंजी आपके कौन-से रिकॉर्ड सूचीबद्ध और संपादित कर सकती है।

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

रिकॉर्ड का दायरा

कुंजी क्या सूचीबद्ध और संपादित कर सकती है

केवल इस कुंजी से बने रिकॉर्ड

केवल वे रिकॉर्ड जो इस कुंजी ने बनाए। डैशबोर्ड में या किसी दूसरी कुंजी से बनाए गए आपके रिकॉर्ड इसकी पहुँच से बाहर रहते हैं, इसलिए दो इंटीग्रेशन कभी एक-दूसरे के काम में दखल नहीं देते।

मेरा पूरा खाता

आपके खाते का हर रिकॉर्ड, चाहे वह कहीं भी बनाया गया हो। AI असिस्टेंट को आमतौर पर इसकी ज़रूरत होती है, क्योंकि आप उससे उन चीज़ों के बारे में पूछते हैं जो आपने खुद बनाई हैं।

नई कुंजी केवल इस कुंजी से बने रिकॉर्ड पर शुरू होती है, और इस सेटिंग के आने से पहले बनी हर कुंजी भी। इसे बदलने के लिए, कुंजी की कार्रवाइयाँ खोलें और रिकॉर्ड का दायरा बदलें चुनें। कुंजी का MCP लिंक उसी कुंजी के रिकॉर्ड के दायरे का उपयोग करता है।

अंतिम उपयोग और कुंजी रद्द करना

अंतिम बार उपयोग किया गया कॉलम दिखाता है कि कुंजी ने आखिरी बार कब अनुरोध किया। यह हर कुछ मिनट में अधिकतम एक बार अपडेट होता है, इसलिए लगातार उपयोग में रहने वाली कुंजी कुछ मिनट पीछे दिख सकती है।

कुंजी रद्द करने के लिए, सूची में उसकी कार्रवाइयाँ खोलें, रद्द करें चुनें और पुष्टि करें।

यह तुरंत काम करना बंद कर देती है। इसका उपयोग करने वाले हर ऐप, स्क्रिप्ट और इंटीग्रेशन को अगले अनुरोध पर 401 मिलता है।
इसका AI असिस्टेंट (MCP) लिंक भी उसी पल बंद हो जाता है।
रद्द करना पूर्ववत नहीं किया जा सकता। अगर फिर से ज़रूरत हो, तो नई कुंजी बनाएँ।
कुंजी ने जो पहले किया है वह बना रहता है। इसके बनाए रिकॉर्ड आपके खाते में रहते हैं, और इसके शेड्यूल किए गए पोस्ट समय पर प्रकाशित होते हैं, क्योंकि शेड्यूल किया गया प्रकाशन कुंजी का उपयोग नहीं करता।

क्रेडिट

API कुंजी से किया गया कॉल ठीक उतने ही क्रेडिट लेता है जितना वही कार्रवाई डैशबोर्ड में लेती है, और क्रेडिट उसी खाते से कटते हैं जिसकी यह कुंजी है। हर कार्रवाई की कीमत यहाँ दी गई है, फ़ीचर क्रेडिट

कुंजियों को सुरक्षित रखें

कुंजियों को सर्वर पर रखें। किसी कुंजी को कभी भी वेब पेज, मोबाइल ऐप या सार्वजनिक रिपॉज़िटरी में न डालें — जो भी इसे पढ़ेगा, वह आपकी ओर से कार्य कर सकता है।
कुंजी, कुंजियों को प्रबंधित नहीं कर सकती। कुंजियाँ बनाना, उनकी सूची देखना, उनका नाम बदलना और उन्हें रद्द करना केवल तभी काम करता है जब आप Posty5 में साइन इन हों, इसलिए लीक हुई कुंजी आपकी दूसरी कुंजियाँ नहीं पढ़ सकती और न ही नई बना सकती है।
कुंजी रोटेट करने के लिए, नई कुंजी बनाएँ, अपने इंटीग्रेशन को उस पर ले जाएँ, जाँचें कि नई कुंजी की अंतिम बार उपयोग की तारीख बदल रही है, फिर पुरानी कुंजी रद्द करें।
अगर कोई कुंजी लीक हो जाए, तो उसे तुरंत रद्द करें और नई कुंजी बनाएँ।