لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

پارٹنر API توثیق: Bearer ec_live_ کلیدیں، روٹیشن اور 401 خرابیاں

ہر Partner API درخواست اکاؤنٹ کی خفیہ کلید Authorization: Bearer ec_live_… ہیڈر میں لے کر جاتی ہے، جو آپ کے سرور سے بھیجی جاتی ہے۔ ہر easyCoexistence اکاؤنٹ کی ایک کلید ہوتی ہے، جو ڈیش بورڈ میں Profile، Developers کے تحت بنتی ہے، یا کسی AI اسسٹنٹ کو create_api_key چلانے کا کہہ کر بنائی جاتی ہے، اور صرف ایک بار دکھائی جاتی ہے۔ کلید کو روٹیٹ کرنے سے نئی کلید جاری ہوتی ہے اور پرانی فوراً ختم ہو جاتی ہے؛ کلید غائب ہو یا غلط ہو تو 401 unauthorized خرابی ملتی ہے۔

ec_live_

وہ پریفکس جس سے ہر Partner API کلید شروع ہوتی ہے، جو ہر درخواست کے ساتھ Authorization: Bearer میں بھیجا جاتا ہے۔

1 key

ایک اکاؤنٹ کے پاس ایک وقت میں موجود کلیدوں کی تعداد؛ اس کے ساتھ بنایا گیا ہر کنکشن اسی اکاؤنٹ کا ہوتا ہے۔

401

غائب یا غلط کلید کے لیے اسٹیٹس، ایرر کوڈ unauthorized کے ساتھ، اور ایک میسج جو متوقع ہیڈر کا نام بتاتا ہے۔

Once

وہ مرتبہ جب پوری کلید دکھائی جاتی ہے، یعنی بنانے یا روٹیٹ کرنے کے وقت؛ بعد میں صرف اس کے ابتدائی حروف نظر آتے ہیں۔

درخواست کی توثیق کیسے ہوتی ہے؟

ہر درخواست میں https://easycoexistence.com/api/v1 پر کلید کو Authorization ہیڈر میں Bearer ٹوکن کے طور پر بھیجا جاتا ہے۔ اس کے علاوہ کچھ اور سائن یا اسکوپ نہیں ہوتا: کلید اکاؤنٹ کی شناخت کرتی ہے، اور درخواست جو کچھ بناتی یا پڑھتی ہے وہ اسی اکاؤنٹ کا ہوتا ہے۔ باڈیز JSON ہوتی ہیں، اور ہر خرابی ایک آبجیکٹ کی صورت میں آتی ہے جس میں code اور message ہوتے ہیں۔

List the account's numbers
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 جواب دیتا ہے، ساتھ ہی دوبارہ کوشش سے پہلے انتظار کے سیکنڈ۔

401 Unauthorized
{
  "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 کے ساتھ یہ کام کرنا

easyCoexistence ہر اکاؤنٹ کو ایک Partner API کلید دیتا ہے، تاکہ آپ کا بیک اینڈ اپنے گاہکوں کے WhatsApp نمبر، ان کے Instagram، Facebook، TikTok، YouTube اور LinkedIn اکاؤنٹس، اور مزید چینلز کو کنیکٹ کر سکے، پھر ہر کنکشن کی کریڈینشلز پڑھ سکے اور اس کے ایونٹس کو روٹ کر سکے۔ قیمت فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک ہے، جیسے جیسے کنکشن بڑھیں یہ کم ہوتی جاتی ہے، اور پہلے 3 دن فری ٹرائل ہے۔

اکثر پوچھے جانے والے سوالات

کیا ایک اکاؤنٹ کے پاس ایک سے زیادہ API کلید ہو سکتی ہے؟

نہیں۔ ایک وقت میں ایک اکاؤنٹ کے پاس ایک کلید ہوتی ہے، اور نئی بنانے سے پرانی کی جگہ لے لیتی ہے۔ الگ کلیدوں کا مطلب الگ easyCoexistence اکاؤنٹس ہیں، ہر ایک کے اپنے کنکشن اور اپنا بل۔

کیا Partner API کلیدیں ختم ہوتی ہیں؟

نہیں۔ کلید اس وقت تک کام کرتی ہے جب تک اسے روٹیٹ یا منسوخ نہ کیا جائے، یا جب تک easyCoexistence غلط استعمال پر اسے ختم نہ کر دے۔

کیا میرے گاہکوں کو کنیکٹ کرنے کے لیے میری کلید چاہیے؟

نہیں۔ وہ صرف ہوسٹڈ کنیکٹ لنک کھولتے ہیں، جس کے ساتھ اپنا سیشن آئی ڈی ہوتا ہے۔ کلید آپ کے سرور پر رہتی ہے اور صرف آپ کا بیک اینڈ اسے استعمال کرتا ہے۔

کیا API کلید اور ایونٹس کا سائننگ سیکرٹ ایک ہی ہیں؟

نہیں۔ کلید آپ کی درخواستوں کی API کے سامنے توثیق کرتی ہے۔ سائننگ سیکرٹ، جو ایونٹس URL سیٹ کرتے وقت ایک بار دکھایا جاتا ہے، آپ کے اینڈ پوائنٹ کو وہ ایونٹس جانچنے دیتا ہے جو easyCoexistence بھیجتا ہے۔

مزید پڑھیں

اپنی ایپ میں صارفین کو واٹس ایپ، انسٹاگرام اور ٹک ٹاک اکاؤنٹس کنیکٹ کرنے دیںہوسٹڈ کنیکٹ لنکس آپ کے صارفین کے واٹس ایپ نمبرز اور سوشل اکاؤنٹس کے لیے: سیشن کی درخواست، ری ڈائریکٹ، اسٹیٹس، میعاد اور دوبارہ کوشش۔SaaS پلیٹ فارمز کے لیے یونیفائیڈ API قیمت: فی کنکشن US$ 9 سے US$ 0.75 تکپلیٹ فارم کے صارفین کے چینلز کی قیمت: فی کنکشن US$ 9 سے US$ 0.75 تک، 10، 100 اور 1,000 صارفین کے حساب کے ساتھ، Meta کے چارجز الگ رکھے گئے ہیں۔Partner API کی حدیں اور قواعد: Meta کی پالیسیاں، فی سیکنڈ 20 میسج اور 14 دن کا اصولپلیٹ فارم کے گاہکوں کے چینلز کے قواعد: Meta کی WhatsApp پالیسیاں، فی Coexistence نمبر 20 میسج فی سیکنڈ، 14 دن کا اصول اور کلید کے ختم ہونے کی وجوہات۔MCP ٹولز کا حوالہEasyCoexistence MCP کنیکٹر کے ٹولز، جو کل 30 سے زیادہ ہیں، ان کی ضرورتیں اور بلنگ رکنے پر محدود ہونے والے ٹولز۔Python سے ایک API کے ذریعے Instagram، TikTok اور Facebook پر پوسٹ کریںPython سے Instagram، Facebook، TikTok، YouTube اور LinkedIn پر پوسٹ شائع کریں، کمنٹس پڑھیں اور DMs کا جواب دیں، ہر نیٹ ورک کے سرکاری API کے ذریعے۔ایک API کے ذریعے Node.js سے Instagram، TikTok اور Facebook پر پوسٹ کریںfetch کے ساتھ Node.js اور TypeScript سے Instagram، Facebook، TikTok، YouTube اور LinkedIn پر پوسٹ، شیڈول اور جواب دیں، اور ایجنٹ کے لیے MCP ٹولز۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ