Partner एपीआई प्रमाणीकरण: Bearer ec_live_ कुंजियाँ, रोटेशन और 401 गड़बड़ियाँ
हर Partner एपीआई अनुरोध खाते की गुप्त कुंजी को Authorization: Bearer ec_live_… हेडर में लेकर जाता है, जिसे आपका सर्वर भेजता है। हर easyCoexistence खाते की एक कुंजी होती है, जो डैशबोर्ड में प्रोफ़ाइल, फिर डेवलपर्स के अंतर्गत बनती है, या किसी AI असिस्टेंट से create_api_key चलाने को कहकर बनवाई जा सकती है, और सिर्फ़ एक बार दिखती है। रोटेट करने पर नई कुंजी जारी होती है और पुरानी तुरंत बंद हो जाती है; कुंजी गायब हो या गलत हो तो 401 unauthorized मिलता है।
हर Partner एपीआई कुंजी जिस प्रीफ़िक्स से शुरू होती है, उसे हर अनुरोध में Authorization: Bearer के रूप में भेजा जाता है।
एक समय पर खाता कितनी कुंजियाँ रख सकता है; उसके साथ बने हर कनेक्शन उसी खाते के होते हैं।
गायब या गलत कुंजी के लिए स्टेटस, त्रुटि कोड unauthorized और एक संदेश जिसमें अपेक्षित हेडर का नाम होता है।
पूरी कुंजी कब दिखती है: बनाते या रोटेट करते समय; उसके बाद सिर्फ़ उसके पहले कुछ अक्षर दिखते हैं।
अनुरोध कैसे प्रमाणित होता है?
हर अनुरोध में https://easycoexistence.com/api/v1 पर Authorization हेडर में Bearer टोकन के रूप में कुंजी भेजी जाती है। और कुछ भी साइन या स्कोप नहीं होता: कुंजी खाते की पहचान करती है, और अनुरोध जो कुछ बनाता या पढ़ता है, वह सब उसी खाते का होता है। बॉडी JSON होती है, और हर त्रुटि एक ऑब्जेक्ट के रूप में लौटती है, जिसमें कोड और संदेश होता है।
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"कुंजी कहाँ बनाते हैं?
डैशबोर्ड से या AI असिस्टेंट से, दोनों से एक ही परिणाम मिलता है। डैशबोर्ड में प्रोफ़ाइल खोलें, फिर डेवलपर्स, और एपीआई कुंजी बनाएँ दबाएँ। Claude, ChatGPT या easyCoexistence के MCP सर्वर से जुड़े किसी दूसरे असिस्टेंट में उससे Partner एपीआई सेट करने को कहें: get_partner_setup बताता है कि क्या कमी है, और create_api_key कुंजी लौटाता है। दोनों तरीकों से पूरी कुंजी एक बार दिखती है, इसलिए उसे तुरंत अपने बैकएंड के सीक्रेट्स में सहेज लें।
कुंजी सिर्फ़ एक बार क्यों दिखती है?
क्योंकि उसका केवल हैश संग्रहीत होता है। easyCoexistence हर अनुरोध की जाँच के लिए हैश रखता है, साथ ही कुंजी के पहले अक्षर ec_live_ और छह और अक्षर, ताकि डैशबोर्ड दिखा सके कि कौन सी कुंजी चालू है और कब बनी थी। खोई हुई कुंजी दोबारा नहीं दिखाई जा सकती; रोटेट करने पर उसकी जगह नई कुंजी आती है।
कुंजी कैसे रोटेट या रद्द करें?
एक ही चरण में, और पुरानी कुंजी उसी क्षण काम करना बंद कर देती है, बिना किसी ग्रेस पीरियड के, क्योंकि कुंजी लीक होना ही रोटेट करने का आम कारण है। नई कुंजी पहली की तरह एक बार दिखती है:
- डैशबोर्ड: प्रोफ़ाइल, डेवलपर्स, रोटेट कुंजी।
- MCP:
replace_existingको true सेट करकेcreate_api_key। उसके बिना टूल कुंजी मौजूद रहते हुए मना कर देता है, ताकि चल रहा इंटीग्रेशन गलती से न टूटे। - सारी पहुँच रोकने के लिए इसके बजाय रद्द करें: डैशबोर्ड में रद्द करें, या confirm को true सेट करके
revoke_api_key। फिर नई कुंजी बनने तक अनुरोध विफल होते हैं।
गायब या गलत कुंजी पर क्या लौटता है?
401 के साथ कोड unauthorized, उस अनुरोध के लिए जिसमें Authorization हेडर नहीं है, जिस कुंजी की शुरुआत ec_live_ से नहीं होती, या जिसे रोटेट या रद्द किया जा चुका है। संदेश उस हेडर का नाम बताता है जिसकी अपेक्षा है। जब विफल अनुरोध किसी एक पते से लगातार आते रहें, तो API इसके बजाय 429 rate_limited लौटाता है, साथ में दोबारा कोशिश से पहले प्रतीक्षा के सेकंड।
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}एक वैध कुंजी को और किस कारण मना किया जा सकता है?
वैध कुंजी खाते को प्रमाणित करती है, पर खाते की स्थिति फिर भी लागू होती है। ये भी उसी त्रुटि आकार में लौटते हैं:
- 402
billing_required: खाते पर अभी तक कार्ड नहीं है, इसलिए कनेक्ट सेशन शुरू नहीं हो सकते। - 404
not_found: यह id इस खाते के किसी कनेक्शन, चैनल या सेशन का नहीं है, दूसरे खातों पर मौजूद वाले भी इसमें शामिल हैं। - 409 removed: कनेक्शन हटाया जा चुका है, इसलिए उसका वेबहुक अब नहीं बदला जा सकता।
- 402 suspended: सब्सक्रिप्शन खत्म होने के बाद कनेक्शन निलंबित है; पहले उसे फिर से कनेक्ट करें।
- 429
cap_reachedयाrate_limited: बहुत सारे खुले कनेक्ट सेशन, या इस घंटे में बहुत सारे बनाए गए।
आम गड़बड़ियाँ
- कुंजी फ़्रंट-एंड कोड में रखना। जो भी पेज खोलेगा, वह उसे पढ़ सकता है, आपके नाम पर बिल होने वाले कनेक्शन बना सकता है, और ?credentials=1 से आपके ग्राहकों के टोकन ला सकता है।
- आपका बैकएंड नई कुंजी स्वीकार कर सके उससे पहले रोटेट करना। पुरानी कुंजी तुरंत बंद हो जाती है, इसलिए नई कुंजी डिप्लॉय होने तक हर अनुरोध 401 से विफल होता है।
- ऐसी बातचीत में कुंजी बनाना जो आप किसी के साथ साझा करते हैं। create_api_key उसे चैट में लौटाता है, जहाँ वह इतिहास में रह जाती है, इसलिए अगर वह बातचीत साझा हुई है तो कुंजी रोटेट करें।
- कुंजी को उद्धरण चिह्नों में सहेजना। Bearer के बाद जो भी है वह कुंजी के रूप में पढ़ा जाता है, इसलिए उद्धरण वाला मान कभी मेल नहीं खाता और हर अनुरोध 401 पाता है।
easyCoexistence हर खाते को एक Partner एपीआई कुंजी देता है, ताकि आपका बैकएंड आपके ग्राहकों के WhatsApp नंबर और उनके Instagram, Facebook, TikTok, YouTube और LinkedIn खाते जोड़ सके, और अन्य चैनल भी, फिर हर कनेक्शन के क्रेडेंशियल पढ़कर उसके इवेंट रूट कर सके। US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, जैसे-जैसे कनेक्शन जुड़ते हैं वैसे घटते हुए, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
एक खाते के पास एक से ज़्यादा एपीआई कुंजी हो सकती है?
नहीं। एक समय पर एक खाते के पास एक ही कुंजी होती है, और नई बनाने से पुरानी की जगह ले लेती है। अलग कुंजियों का मतलब अलग easyCoexistence खाते हैं, हर एक के अपने कनेक्शन और अपना बिल।
क्या Partner एपीआई कुंजियाँ एक्सपायर होती हैं?
नहीं। कुंजी तब तक काम करती है जब तक उसे रोटेट या रद्द न किया जाए, या easyCoexistence उसे Meta के नियमों के दुरुपयोग के लिए बंद न कर दे।
क्या कनेक्ट करने के लिए मेरे ग्राहकों को मेरी कुंजी चाहिए?
नहीं। वे केवल होस्टेड कनेक्ट लिंक खोलते हैं, जिसमें अपनी सेशन id होती है। कुंजी आपके सर्वर पर रहती है और सिर्फ़ आपका बैकएंड उसका उपयोग करता है।
क्या एपीआई कुंजी और इवेंट साइनिंग सीक्रेट एक ही हैं?
नहीं। कुंजी आपके अनुरोधों को एपीआई तक प्रमाणित करती है। साइनिंग सीक्रेट, जो आप स्टेटस इवेंट URL सेट करते समय एक बार दिखता है, आपके एंडपॉइंट को वे इवेंट सत्यापित करने देता है जो easyCoexistence भेजता है।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित