Partner API प्रमाणीकरण: Bearer ec_live_ की, बदल आणि 401 त्रुटी
प्रत्येक Partner API विनंतीमध्ये खात्याची गुप्त की Authorization: Bearer ec_live_… या हेडरमध्ये पाठवली जाते, जी तुमच्या सर्व्हरवरून जाते. प्रत्येक easyCoexistence खात्याची एक की असते, जी डॅशबोर्डमध्ये Profile, Developers येथे किंवा AI सहाय्यकाला create_api_key चालवायला सांगून तयार करता येते, आणि ती फक्त एकदाच दाखवली जाते. की बदलल्यावर नवी की मिळते आणि जुनी लगेच बंद होते; की नसल्यास किंवा चुकीची असल्यास 401 unauthorized त्रुटी मिळते.
प्रत्येक Partner API की सुरू होणारा प्रीफिक्स, जो प्रत्येक विनंतीत 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 सहाय्यकाकडून, दोन्हीकडे एकच परिणाम मिळतो. डॅशबोर्डमध्ये Profile उघडा, नंतर Developers निवडा आणि Create API key दाबा. easyCoexistence च्या MCP सर्व्हरशी जोडलेल्या Claude, ChatGPT किंवा इतर सहाय्यकाला Partner API सेट करायला सांगा: get_partner_setup काय गहाळ आहे ते दाखवतो आणि create_api_key की परत देतो. दोन्ही मार्गांनी पूर्ण की फक्त एकदाच दिसते, म्हणून ती लगेच तुमच्या बॅकएंडच्या सिक्रेट्समध्ये साठवा.
की फक्त एकदाच का दाखवली जाते?
कारण तिचा फक्त हॅश साठवला जातो. easyCoexistence प्रत्येक विनंती तपासण्यासाठी हॅश ठेवते, तसेच की ची पहिली अक्षरे, ec_live_ आणि आणखी सहा अक्षरे, ठेवते, जेणेकरून डॅशबोर्ड कोणती की सक्रिय आहे आणि ती कधी तयार झाली ते दाखवू शकेल. हरवलेली की पुन्हा दाखवता येत नाही; बदलल्याने ती नव्या की ने बदलली जाते.
की कशी बदलायची किंवा रद्द करायची?
एका चरणात. जुनी की त्या क्षणी काम करणे थांबवते, आणि कोणताही सवलतीचा कालावधी नसतो, कारण की गळती हेच की बदलण्याचे सामान्य कारण असते. नवी की एकदाच दाखवली जाते, पहिल्यासारखीच:
- डॅशबोर्ड: Profile, Developers, Rotate key.
- MCP:
create_api_keyलाreplace_existingtrue सेट करून वापरा. त्याशिवाय, की अस्तित्वात असताना टूल नकार देते, त्यामुळे चालू असलेले इंटिग्रेशन चुकून तुटत नाही. - सर्व प्रवेश थांबवायचा असल्यास रद्द करा: डॅशबोर्डमध्ये Revoke, किंवा confirm true सेट करून
revoke_api_key. त्यानंतर नवी की तयार होईपर्यंत विनंत्या अयशस्वी होतात.
की गहाळ किंवा चुकीची असल्यास काय परत येते?
401 आणि त्रुटी कोड unauthorized मिळतो, जेव्हा Authorization हेडर नसते, की ec_live_ ने सुरू होत नाही, किंवा की बदलली किंवा रद्द झालेली असते. मेसेजमध्ये अपेक्षित हेडर नमूद केलेले असते. एका पत्त्यावरून अयशस्वी विनंत्या सतत येत असल्यास, एपीआय त्याऐवजी 429 rate_limited देते, ज्यासोबत पुन्हा प्रयत्न करण्यापूर्वी थांबायची सेकंदांची संख्या दिलेली असते.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}वैध की असूनही आणखी काय नाकारली जाऊ शकते?
वैध की खात्याला प्रमाणित करते, आणि खात्याची स्थिती तरीही लागू होते. हे त्याच त्रुटी स्वरूपात परत येतात:
- 402
billing_required: खात्यावर अद्याप कार्ड नाही, त्यामुळे कनेक्ट सेशन सुरू होऊ शकत नाहीत. - 404
not_found: या आयडीचे या खात्याचे कोणतेही कनेक्शन, चॅनेल किंवा सेशन नाही, इतर खात्यांवरीलही नाही. - 409 removed: कनेक्शन काढले गेले आहे, त्यामुळे त्याचे वेबहुक बदलता येत नाही.
- 402 suspended: सबस्क्रिप्शन संपल्यामुळे कनेक्शन निलंबित आहे; आधी ते पुन्हा कनेक्ट करा.
- 429
cap_reachedकिंवाrate_limited: खूप जास्त उघडे कनेक्ट सेशन, किंवा या तासात खूप जास्त तयार केलेले.
सामान्य चुका
- की front-end कोडमध्ये टाकणे. पेज उघडणारा कोणीही ती वाचू शकतो, तुमच्या खर्चावर कनेक्शन तयार करू शकतो आणि ?credentials=1 वापरून तुमच्या ग्राहकांचे टोकन मिळवू शकतो.
- बॅकएंड नवी की स्वीकारू शकण्यापूर्वी की बदलणे. जुनी की लगेच थांबते, त्यामुळे नवी की डिप्लॉय होईपर्यंत प्रत्येक विनंती 401 ने अयशस्वी होते.
- शेअर केलेल्या संभाषणात की तयार करणे. create_api_key ती चॅटमध्ये परत देते, जिथे ती इतिहासात राहते, त्यामुळे ते संभाषण शेअर केलेले असल्यास की बदला.
- की अवतरण चिन्हांमध्ये साठवणे. Bearer नंतरचे सर्व काही की म्हणून वाचले जाते, त्यामुळे अवतरणांतील मूल्य कधीच जुळत नाही आणि प्रत्येक विनंतीला 401 मिळते.
easyCoexistence प्रत्येक खात्याला एक Partner API की देते, जेणेकरून तुमचा बॅकएंड तुमच्या ग्राहकांचे WhatsApp नंबर आणि त्यांची Instagram, Facebook, TikTok, YouTube व LinkedIn खाती जोडू शकेल, आणखी चॅनेलसह, आणि प्रत्येक कनेक्शनचे क्रेडेन्शियल वाचून त्याचे इव्हेंट राउट करू शकेल. प्रति कनेक्शन प्रति महिना US$ 9 ते US$ 0.75, जसजसे कनेक्शन वाढवाल तसा दर कमी होत जातो, आणि 3 दिवसांचा ट्रायल मोफत.
वारंवार विचारले जाणारे प्रश्न
एका खात्याकडे एकापेक्षा जास्त Partner API की असू शकतात का?
नाही. एका वेळी खात्याकडे एकच की असते, आणि नवी तयार केल्यास ती जुनी बदलते. वेगळ्या की म्हणजे वेगळी easyCoexistence खाती, प्रत्येकाची स्वतःची कनेक्शन आणि स्वतःचे बिल असते.
Partner API की कालबाह्य होतात का?
नाही. की बदलली किंवा रद्द होईपर्यंत, किंवा Meta च्या नियमांच्या गैरवापरामुळे easyCoexistence ती बंद करेपर्यंत काम करते.
माझ्या ग्राहकांना कनेक्ट करण्यासाठी माझी की लागते का?
नाही. ते फक्त होस्ट केलेली कनेक्ट लिंक उघडतात, जी स्वतःचा सेशन आयडी घेऊन येते. की तुमच्या सर्व्हरवरच राहते आणि फक्त तुमचा बॅकएंड वापरतो.
API की आणि इव्हेंट साइनिंग सिक्रेट एकच आहे का?
नाही. की तुमच्या विनंत्या एपीआयला प्रमाणित करते. साइनिंग सिक्रेट, status events URL सेट करताना एकदाच दाखवले जाते, ते तुमच्या एंडपॉइंटला easyCoexistence पाठवलेले इव्हेंट पडताळून पाहू देते.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: