پارٹنر 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 ہوتی ہیں، اور ہر خرابی ایک آبجیکٹ کی صورت میں آتی ہے جس میں code اور message ہوتے ہیں۔
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_existingکے true کے ساتھ چلائیں۔ اس کے بغیر کلید موجود ہونے پر ٹول انکار کرتا ہے، تاکہ چلتا ہوا انٹیگریشن غلطی سے نہ ٹوٹے۔ - تمام رسائی روکنے کے لیے منسوخ کریں: ڈیش بورڈ میں 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: یہ آئی ڈی اس اکاؤنٹ کے کسی کنکشن، چینل یا سیشن سے تعلق نہیں رکھتی، دوسرے اکاؤنٹس کے کنکشن بھی شامل ہیں۔ - 409 removed: کنکشن ہٹایا جا چکا ہے، اس لیے اس کا ویب ہک تبدیل نہیں ہو سکتا۔
- 402 suspended: سبسکرپشن ختم ہونے کے بعد کنکشن معطل ہے؛ پہلے اسے دوبارہ کنیکٹ کریں۔
- 429
cap_reachedیاrate_limited: بہت زیادہ کھلے کنیکٹ سیشنز، یا اس گھنٹے میں بہت زیادہ بنائے گئے۔
عام غلطیاں
- کلید کو فرنٹ اینڈ کوڈ میں رکھنا۔ جو بھی صفحہ کھولے وہ اسے پڑھ سکتا ہے، آپ کے نام پر بلنگ ہونے والے کنکشن بنا سکتا ہے، اور query string ?credentials=1 کے ذریعے آپ کے گاہکوں کے ٹوکن حاصل کر سکتا ہے۔
- نئی کلید اپنے بیک اینڈ پر لینے سے پہلے روٹیٹ کرنا۔ پرانی کلید فوراً بند ہو جاتی ہے، اس لیے نئی کلید ڈپلائے ہونے تک ہر درخواست 401 کے ساتھ ناکام ہوگی۔
- ایسی گفتگو میں کلید بنانا جو آپ شیئر کرتے ہیں۔ create_api_key اسے چیٹ میں واپس دیتا ہے، جہاں وہ ہسٹری میں رہتی ہے، اس لیے اگر وہ گفتگو شیئر ہو تو کلید روٹیٹ کریں۔
- کلید کو واوین میں محفوظ کرنا۔ Bearer کے بعد کی ہر چیز کلید سمجھی جاتی ہے، اس لیے واوین والی قدر کبھی میل نہیں کھاتی اور ہر درخواست 401 لیتی ہے۔
easyCoexistence ہر اکاؤنٹ کو ایک Partner API کلید دیتا ہے، تاکہ آپ کا بیک اینڈ اپنے گاہکوں کے WhatsApp نمبر، ان کے Instagram، Facebook، TikTok، YouTube اور LinkedIn اکاؤنٹس، اور مزید چینلز کو کنیکٹ کر سکے، پھر ہر کنکشن کی کریڈینشلز پڑھ سکے اور اس کے ایونٹس کو روٹ کر سکے۔ قیمت فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک ہے، جیسے جیسے کنکشن بڑھیں یہ کم ہوتی جاتی ہے، اور پہلے 3 دن فری ٹرائل ہے۔
اکثر پوچھے جانے والے سوالات
کیا ایک اکاؤنٹ کے پاس ایک سے زیادہ API کلید ہو سکتی ہے؟
نہیں۔ ایک وقت میں ایک اکاؤنٹ کے پاس ایک کلید ہوتی ہے، اور نئی بنانے سے پرانی کی جگہ لے لیتی ہے۔ الگ کلیدوں کا مطلب الگ easyCoexistence اکاؤنٹس ہیں، ہر ایک کے اپنے کنکشن اور اپنا بل۔
کیا Partner API کلیدیں ختم ہوتی ہیں؟
نہیں۔ کلید اس وقت تک کام کرتی ہے جب تک اسے روٹیٹ یا منسوخ نہ کیا جائے، یا جب تک easyCoexistence غلط استعمال پر اسے ختم نہ کر دے۔
کیا میرے گاہکوں کو کنیکٹ کرنے کے لیے میری کلید چاہیے؟
نہیں۔ وہ صرف ہوسٹڈ کنیکٹ لنک کھولتے ہیں، جس کے ساتھ اپنا سیشن آئی ڈی ہوتا ہے۔ کلید آپ کے سرور پر رہتی ہے اور صرف آپ کا بیک اینڈ اسے استعمال کرتا ہے۔
کیا API کلید اور ایونٹس کا سائننگ سیکرٹ ایک ہی ہیں؟
نہیں۔ کلید آپ کی درخواستوں کی API کے سامنے توثیق کرتی ہے۔ سائننگ سیکرٹ، جو ایونٹس URL سیٹ کرتے وقت ایک بار دکھایا جاتا ہے، آپ کے اینڈ پوائنٹ کو وہ ایونٹس جانچنے دیتا ہے جو easyCoexistence بھیجتا ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ