Partner API प्रमाणीकरण: Bearer ec_live_ कुञ्जी, रोटेसन र 401 त्रुटि
हरेक Partner API अनुरोधले खाताको गोप्य कुञ्जी Authorization: Bearer ec_live_… हेडरमा बोक्छ, जुन तपाईंको सर्भरबाट पठाइन्छ। हरेक easyCoexistence खातामा एउटा कुञ्जी हुन्छ, जुन ड्यासबोर्डमा Profile, Developers अन्तर्गत बनाइन्छ, वा कुनै एआई सहायकलाई 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"कुञ्जी कहाँ बनाउने?
ड्यासबोर्ड वा एआई सहायकबाट, एउटै नतिजासहित। ड्यासबोर्डमा Profile खोल्नुहोस्, त्यसपछि Developers खोल्नुहोस्, र Create API key थिच्नुहोस्। Claude, ChatGPT वा easyCoexistence को MCP सर्भरसँग जडान भएको अन्य सहायकलाई Partner API सेटअप गर्न भन्नुहोस्: get_partner_setup ले के बाँकी छ देखाउँछ र create_api_key ले कुञ्जी फर्काउँछ। दुवै तरिकामा पूरा कुञ्जी एकपटक मात्र देखिन्छ, त्यसैले तुरुन्तै तपाईंको ब्याकएन्डको सिक्रेट्समा राख्नुहोस्।
किन कुञ्जी एकपटक मात्र देखाइन्छ?
किनभने यसको केवल ह्यास भण्डारण गरिन्छ। easyCoexistence ले हरेक अनुरोध जाँच्न ह्यास राख्छ, र कुञ्जीको पहिलो अक्षरहरू: ec_live_ र थप छ वटा, ताकि ड्यासबोर्डले कुन कुञ्जी सक्रिय छ र कहिले बनेको हो देखाउन सकोस्। हराएको कुञ्जी फेरि देखाउन सकिँदैन; रोटेसनले त्यसलाई बदल्छ।
कुञ्जी कसरी रोटेट वा रद्द गर्ने?
एकै चरणमा, र पुरानो कुञ्जी त्यही क्षणदेखि काम गर्न छाड्छ, कुनै ग्रेस अवधि हुँदैन, किनभने चुहिनु नै रोटेट गर्ने सामान्य कारण हो। नयाँ कुञ्जी पहिलोझैँ एकपटक मात्र देखिन्छ:
- ड्यासबोर्डमा Profile, Developers, र त्यसपछि Rotate key थिच्नुहोस्।
- MCP:
create_api_keyलाईreplace_existingtrue सेट गरेर चलाउनुहोस्। त्यो नभए, कुञ्जी अस्तित्वमा रहँदा उपकरणले अस्वीकार गर्छ, ताकि चलिरहेको एकीकरण अनजानमा नबिग्रियोस्। - सबै पहुँच रोक्न, बरु रद्द गर्नुहोस्: ड्यासबोर्डमा Revoke, वा
revoke_api_keyलाई confirm true सेट गरेर। त्यसपछि नयाँ कुञ्जी नबनाउन्जेल अनुरोधहरू असफल हुन्छन्।
हराएको वा गलत कुञ्जीमा के फर्किन्छ?
अनुरोधमा Authorization हेडर छैन, कुञ्जी ec_live_ बाट सुरु हुँदैन, वा कुञ्जी रोटेट वा रद्द भएको छ भने 401 unauthorized फर्किन्छ। म्यासेजले अपेक्षित हेडरको नाम उल्लेख गर्छ। एउटै ठेगानाबाट असफल अनुरोधहरू आइरहेमा, एपीआई बरु 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 API कुञ्जी दिन्छ, ताकि तपाईंको ब्याकएन्डले तपाईंका ग्राहकहरूको WhatsApp नम्बर र उनीहरूका Instagram, Facebook, TikTok, YouTube र LinkedIn खाताहरू, र थप च्यानलहरू जडान गर्न सकोस्, त्यसपछि हरेक कनेक्सनको क्रेडेन्सियल पढेर त्यसका इभेन्टहरू रुट गर्न सकोस्। प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, कनेक्सन थपिँदै जाँदा घट्दै, र पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
के एउटा खातामा एकभन्दा बढी एपीआई कुञ्जी हुन सक्छ?
हुँदैन। खातामा एकपटकमा एउटा कुञ्जी हुन्छ, र नयाँ बनाउँदा त्यो बदलिन्छ। फरक कुञ्जी भनेको फरक easyCoexistence खाता हो, जसका आफ्नै कनेक्सन र आफ्नै बिल हुन्छन्।
के Partner API कुञ्जीको म्याद सकिन्छ?
सकिँदैन। कुञ्जी रोटेट वा रद्द नभएसम्म, वा easyCoexistence ले Meta को नियमहरूको दुरुपयोगका कारण यसलाई समाप्त नगरेसम्म काम गर्छ।
जडान गर्न मेरा ग्राहकहरूलाई मेरो कुञ्जी चाहिन्छ?
चाहिँदैन। उनीहरूले होस्ट गरिएको जडान लिंक मात्र खोल्छन्, जसमा आफ्नै सत्र id हुन्छ। कुञ्जी तपाईंको सर्भरमा रहन्छ र तपाईंको ब्याकएन्डले मात्र प्रयोग गर्छ।
के एपीआई कुञ्जी र इभेन्टको हस्ताक्षर गोप्य कुञ्जी एउटै हो?
होइन। कुञ्जीले तपाईंका अनुरोधहरू एपीआईमा प्रमाणित गर्छ। हस्ताक्षर गोप्य कुञ्जी, जुन स्ट्याटस इभेन्ट्स यूआरएल सेट गर्दा एकपटक देखाइन्छ, ले तपाईंको एन्डपोइन्टलाई easyCoexistence ले पठाएका इभेन्टहरू प्रमाणित गर्न दिन्छ।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको