Partner API සත්යාපනය: Bearer ec_live_ keys, rotate කිරීම සහ 401 දෝෂ
සෑම Partner API request එකකම ගිණුමේ රහස් key එක Authorization: Bearer ec_live_… header එකේ යවයි, ඔබේ server එකෙන්. easyCoexistence ගිණුමකට key එකක් පමණක් ඇත, එය dashboard එකේ Profile, Developers යටතේ හෝ AI සහායකයෙකුට create_api_key ධාවනය කිරීමෙන් සාදයි, සහ එක් වරක් පමණක් පෙන්වයි. Rotate කිරීමෙන් නව key එකක් නිකුත් වන අතර පැරණි key එක ක්ෂණිකව අවසන් වේ. key නැති හෝ වැරදි key එකක් 401 unauthorized ලබයි.
සෑම Partner API key එකක්ම ආරම්භ වන prefix එක, සෑම request එකකම Authorization: Bearer ලෙස යවයි.
ගිණුමකට එකවර තබා ගන්නා keys ගණන; එයින් සාදන සෑම සම්බන්ධතාවයක්ම එම ගිණුමට අයත් වේ.
නැති හෝ වලංගු නොවන key එකක් සඳහා status එක 401, දෝෂ කේතය unauthorized, සහ අපේක්ෂිත header එක නම් කරන පණිවිඩය.
සම්පූර්ණ key එක පෙන්වන වාර ගණන, සාදන හෝ rotate කරන විට; පසුව එහි පළමු අක්ෂර පමණක් දිස්වේ.
Request එක සත්යාපනය වන්නේ කෙසේද?
සෑම request එකකම Authorization header එකේ Bearer token එක ලෙස key එක යවයි, https://easycoexistence.com/api/v1 වෙත. වෙනත් කිසිවක් අත්සන් කර හෝ සීමා කර නොමැත: key එක ගිණුම හඳුනා ගනී, සහ request එකක් සාදන හෝ කියවන සියල්ල එම ගිණුමට අයත් වේ. Body එක JSON වලින් ඇත, සහ සෑම දෝෂයක්ම කේතය සහ පණිවිඩයක් සහිත object එකක් ලෙස ලැබේ.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"Key එක කොහෙන් සාදන්නේද?
dashboard එකෙන් හෝ AI සහායකයෙකුගෙන්, එකම ප්රතිඵලය සමඟ. dashboard එකේ Profile, ඉන්පසු Developers විවෘත කර, Create API key ඔබන්න. easyCoexistence හි MCP server එකට සම්බන්ධ Claude, ChatGPT හෝ වෙනත් assistant එකකින්, Partner API සකසන ලෙස ඉල්ලන්න: get_partner_setup මඟින් මොනවා නැතිද කියා පෙන්වයි, සහ create_api_key මඟින් key එක ලැබේ. කෙසේ වුවත් සම්පූර්ණ key එක එක් වරක් දිස්වේ, එබැවින් එය ඔබේ backend එකේ secrets වෙත වහාම ගබඩා කරන්න.
Key එක එක් වරක් පමණක් පෙන්වන්නේ ඇයි?
මොකද එහි hash එක පමණක් ගබඩා කරයි. easyCoexistence එම hash එක සෑම request එකක්ම පරීක්ෂා කිරීමට තබා ගන්නා අතර, key එකේ පළමු අක්ෂර ec_live_ සහ තවත් අක්ෂර හය ද ගබඩා කරයි, එවිට dashboard එකට කුමන key එක සක්රිය දැයි සහ එය කවදා සාදා ඇත්දැයි පෙන්විය හැකිය. නැති වූ key එකක් නැවත පෙන්විය නොහැක; rotate කිරීමෙන් එය ප්රතිස්ථාපනය වේ.
Key එක rotate හෝ revoke කරන්නේ කෙසේද?
එක් පියවරකින්. පැරණි key එක එම මොහොතේ ක්රියා නොකරයි, ඉඩ දීමේ කාලයක් නැත, මන්ද කාන්දුවීමක් වීම rotate කිරීමට සාමාන්ය හේතුවයි. නව key එක පළමු එක මෙන් එක් වරක් පෙන්වයි:
- dashboard එක: Profile, Developers, Rotate key.
- MCP:
create_api_key,replace_existingtrue ලෙස සකසා. එය නැතිව, key එකක් පවතින විට tool එක ප්රතික්ෂේප කරයි, එවිට ධාවනය වන integration එකක් වරදින් නොකැඩේ. - සියලු ප්රවේශය ඒ වෙනුවට නවතන්න, revoke කරන්න: dashboard එකේ Revoke, හෝ
revoke_api_key, confirm true ලෙස සකසා. ඉන්පසු නව key එකක් සාදන තුරු request එක අසමත් වේ.
Key එක නැති හෝ වැරදි නම් කුමක් ලැබේද?
401 සහ unauthorized කේතය ලැබේ: Authorization header එකක් නැති request එකකට, ec_live_ න් ආරම්භ නොවන key එකකට, හෝ rotate හෝ revoke කළ key එකකට. පණිවිඩයෙන් අපේක්ෂිත header එකේ නම නම් කරයි. එකම ලිපිනයකින් අසාර්ථක request දිගින් දිගටම පැමිණෙන විට, API එය 429 rate_limited ලෙස පිළිතුරු දෙයි, නැවත උත්සාහ කිරීමට පෙර තත්පර කීයක් රැඳිය යුතුද යන්න සමඟ.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}වලංගු key එකක් වුවද ප්රතික්ෂේප විය හැක්කේ කුමක් නිසාද?
වලංගු key එකක් ගිණුම සත්යාපනය කරයි, තවමත් ගිණුමේ තත්ත්වය අදාළ වේ. මේවා එකම දෝෂ හැඩයෙන් ලැබේ:
- 402
billing_required: ගිණුමේ තවම card එකක් නැත, එබැවින් connect session සෑදිය නොහැක. - 404
not_found: id එක මෙම ගිණුමේ කිසිම සම්බන්ධතාවයකට, channel එකකට හෝ session එකකට අයත් නැත, වෙනත් ගිණුම්වල ඒවා ද ඇතුළුව. - 409 removed: සම්බන්ධතාවය ඉවත් කර ඇත, එබැවින් එහි webhook එක වෙනස් කළ නොහැක.
- 402 suspended: දායකත්වය කල් ඉකුත් වීමෙන් පසු සම්බන්ධතාවය අත්හිටුවා ඇත; පළමුව එය නැවත සම්බන්ධ කරන්න.
- 429
cap_reachedහෝrate_limited: එකවර විවෘත connect session ගණන හෝ මෙම පැය තුළ සාදන ලද ගණන ඉතා වැඩිය.
සාමාන්ය වැරදි
- key එක front-end කේතය තුළ තැබීම. පිටුව විවෘත කරන ඕනෑම අයෙකුට එය කියවා, ඔබට බිල් වන සම්බන්ධතාවයන් සාදා, ?credentials=1 සමඟ ඔබේ පාරිභෝගිකයින්ගේ token එක ලබා ගත හැක.
- backend එක නව key එක භාවිතා කළ හැකි වීමට පෙර rotate කිරීම. පැරණි key එක එම මොහොතේ නතර වන බැවින්, නව key එක deploy කරන තෙක් සෑම request එකක්ම 401 සමඟ අසමත් වේ.
- ඔබ බෙදා ගන්නා සංවාදයක key එක සෑදීම. create_api_key එය chat එකේ ලබා දෙයි, එහි එය ඉතිහාසයේ පවතී, එබැවින් එම සංවාදය බෙදා ගන්නේ නම් rotate කරන්න.
- key එක උද්ධෘත ලකුණු අතර ගබඩා කිරීම. Bearer ට පසු ඇති සියල්ල key එක ලෙස කියවෙන බැවින්, උද්ධෘත අගය කිසි විටෙක නොගැලපේ, සහ සෑම request එකක්ම 401 ලබයි.
easyCoexistence ගිණුමකට එක Partner API key එකක් ලබා දෙයි, එබැවින් ඔබේ backend එකට ඔබේ පාරිභෝගිකයින්ගේ WhatsApp අංක සහ ඔවුන්ගේ Instagram, Facebook, TikTok, YouTube සහ LinkedIn ගිණුම් සම්බන්ධ කර, තවත් channels ද, එක් එක් සම්බන්ධතාවයේ credentials කියවා එහි events යොමු කළ හැක. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන තරමට අඩු වේ, පළමු දින 3 නොමිලේ trial කාලය.
නිතර අසන ප්රශ්න
ගිණුමකට එකට වඩා API keys තිබිය හැකිද?
නැත. ගිණුමකට එක් වරකට key එකක් ඇත, නව එකක් සෑදීමෙන් එය ප්රතිස්ථාපනය වේ. වෙනම keys යනු වෙනම easyCoexistence ගිණුම් ය, එක් එකක් තමන්ගේම සම්බන්ධතාවයන් සහ තමන්ගේම ගාස්තු සහිතව.
Partner API keys කල් ඉකුත් වේද?
නැත. key එක rotate හෝ revoke කරන තෙක්, නැතහොත් Meta හි නීති අයුතු ලෙස භාවිතා කිරීම නිසා easyCoexistence එය අවසන් කරන තෙක් ක්රියා කරයි.
පාරිභෝගිකයන්ට සම්බන්ධ වීමට මගේ key අවශ්යද?
නැත. ඔව්හු hosted connect link එක පමණක් විවෘත කරයි, එයට තමන්ගේම session id එකක් ඇත. key එක ඔබේ server එකේ පවතින අතර, ඔබේ backend එක පමණක් එය භාවිතා කරයි.
API key එක events signing secret එකම ද?
නැත. key එක ඔබේ request API වෙත සත්යාපනය කරයි. signing secret එක, status events URL එකක් සකසන විට එක් වරක් පෙන්වයි, ඔබේ endpoint එකට easyCoexistence යවන events සත්යාපනය කිරීමට ඉඩ දෙයි.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ