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 அழுத்துங்கள். 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 உடன். அதன் பின் புதிய விசை உருவாக்கும் வரை கோரிக்கைகள் தோல்வியடையும்.
விசை இல்லாத அல்லது தவறான விசைக்கு என்ன கிடைக்கும்?
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: திறந்திருக்கும் இணைப்பு அமர்வுகள் அதிகம், அல்லது இந்த மணி நேரத்தில் அதிகம் உருவாக்கப்பட்டன.
பொதுவான தவறுகள்
- விசையை front-end குறியீட்டில் வைப்பது. பக்கத்தைத் திறக்கும் எவரும் அதைப் படிக்கலாம், உங்கள் கட்டணத்தில் இணைப்புகளை உருவாக்கலாம், ?credentials=1 மூலம் உங்கள் வாடிக்கையாளர்களின் டோக்கன்களைப் பெறலாம்.
- உங்கள் பின்தளம் புதிய விசையை ஏற்கும் முன் சுழற்றுவது. பழைய விசை உடனே நிற்கும், புதிய விசை பயன்பாட்டுக்கு வரும் வரை ஒவ்வொரு கோரிக்கையும் 401 பெறும்.
- பகிரப்படும் உரையாடலில் விசையை உருவாக்குவது. create_api_key அதை அரட்டையில் திருப்பித் தரும், அது வரலாற்றில் தங்கும்; அந்த உரையாடல் பகிரப்பட்டால் விசையை சுழற்றுங்கள்.
- விசையைச் சுற்றி மேற்கோள் குறிகளுடன் சேமிப்பது. Bearer-க்குப் பின் வருவதெல்லாம் விசையாகப் படிக்கப்படும், எனவே மேற்கோள் இடப்பட்ட மதிப்பு ஒருபோதும் பொருந்தாது, ஒவ்வொரு கோரிக்கையும் 401 பெறும்.
easyCoexistence ஒவ்வொரு கணக்குக்கும் ஒரு Partner API விசையை வழங்குகிறது; அதன் மூலம் உங்கள் பின்தளம் உங்கள் வாடிக்கையாளர்களின் WhatsApp எண்களையும் அவர்களின் Instagram, Facebook, TikTok, YouTube மற்றும் LinkedIn கணக்குகளையும், மேலும் பல சேனல்களையும் இணைக்க முடியும்; பிறகு ஒவ்வொரு இணைப்பின் நற்சான்றுகளைப் படித்து அதன் நிகழ்வுகளை வழிநடத்தலாம். ஒரு இணைப்புக்கு மாதத்துக்கு US$ 9 முதல் US$ 0.75 வரை, இணைப்புகள் கூடும்போது குறையும்; முதல் 7 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
ஒரு கணக்குக்கு ஒன்றுக்கு மேற்பட்ட API விசைகள் இருக்க முடியுமா?
முடியாது. ஒரு கணக்குக்கு ஒரு நேரத்தில் ஒரே விசை உண்டு; புதிதாக உருவாக்கினால் அது பழையதை மாற்றும். தனித்தனி விசைகள் என்றால் தனித்தனி easyCoexistence கணக்குகள் என்று பொருள், ஒவ்வொன்றுக்கும் தனி இணைப்புகளும் தனி பில்லும் இருக்கும்.
Partner API விசைகள் காலாவதியாகுமா?
ஆகாது. சுழற்றப்படும் அல்லது ரத்து செய்யப்படும் வரை, அல்லது Meta-வின் விதிகளை மீறியதற்காக easyCoexistence அதை நிறுத்தும் வரை விசை வேலை செய்யும்.
இணைப்பதற்கு என் வாடிக்கையாளர்களுக்கு என் விசை தேவையா?
தேவையில்லை. அவர்கள் தங்களுக்கான அமர்வு id கொண்ட ஹோஸ்ட் செய்யப்பட்ட இணைப்பு இணைப்பை மட்டுமே திறப்பார்கள். விசை உங்கள் சர்வரிலேயே இருக்கும், உங்கள் பின்தளம் மட்டுமே அதைப் பயன்படுத்தும்.
API விசையும் நிகழ்வுகளுக்கான கையொப்பமிடும் ரகசியமும் ஒன்றா?
இல்லை. விசை உங்கள் கோரிக்கைகளை API-க்கு அங்கீகரிக்கிறது. கையொப்பமிடும் ரகசியம், நிலை நிகழ்வுகளின் URL-ஐ அமைக்கும் போது ஒரு முறை காட்டப்படும், easyCoexistence அனுப்பும் நிகழ்வுகளை உங்கள் எண்ட்பாயிண்ட் சரிபார்க்க உதவுகிறது.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: