ڈویلپر API کیز
پبلک API کے لیے صرف پڑھنے والی یا پڑھنے + لکھنے والی کلیدیں بنائیں؛ کلید اس ایڈمن کی ہوتی ہے جس نے اسے بنایا، اور اگر وہ اس کے ورک اسپیسز کا ایڈمن نہ رہے تو کلید کام کرنا بند کر دیتی ہے۔
سیٹنگز، حصہ ڈویلپر API کلیدیں (/app/settings#developer)۔ صرف مالکان اور ایڈمنز کے لیے۔ کلید آپ کے اپنے سافٹ ویئر کو ہیڈر Authorization: Bearer ob_live_… کے ساتھ OmniBrand پبلک API کو کال کرنے دیتی ہے۔
مرحلہ وار: کلید بنائیں
- کلید کا نام (مثلاً CI بوٹ) میں 60 حروف تک کا نام لکھیں، تاکہ بعد میں آپ کو معلوم رہے کہ اسے کیا استعمال کرتا ہے۔
- صرف پڑھنا (ڈیٹا پڑھنا) یا پڑھنا + لکھنا (چیزیں بنانا اور بدلنا بھی) منتخب کریں۔
- کلید بنائیں پر کلک کریں۔
- ایک پیلا خانہ "API کلید (ابھی کاپی کریں - صرف ایک بار دکھائی جاتی ہے):" اور پوری کلید دکھاتا ہے۔ اسے ابھی کاپی کر کے کسی محفوظ جگہ رکھیں؛ OmniBrand صرف اس کا فنگر پرنٹ محفوظ کرتا ہے اور اسے دوبارہ کبھی نہیں دکھا سکتا۔
فہرست
ہر کلید اپنا نام، ابتدائی حروف (ob_live_…)، اپنا دائرہ، آخری بار کب استعمال ہوئی ("استعمال ہوئی ..." یا "کبھی استعمال نہیں ہوئی") اور اپنی آخری تاریخ کے ساتھ "میعاد ختم ..." دکھاتی ہے۔ - Rotate: issues a new key with the same name and scope and shows it once. The old key keeps working for 24 hours so you can switch your integration over, then stops. Until then it stays in the list, not struck through, with "Old key works until {date and time}" and no buttons. - Revoke: stops the key at once. Revoked keys (and rotated keys once their 24 hours are over) stay in the list, struck through.
کلید کا مالک کون ہے
- کلید اس شخص کی ہوتی ہے جس نے اسے بنایا، اور یہ ان ورک اسپیسز کا احاطہ کرتی ہے جہاں بناتے وقت وہ شخص مالک یا ایڈمن تھا۔
- یہ صرف اسی وقت تک کام کرتی ہے جب تک اس کا بنانے والا ان تمام ورک اسپیسز کا فعال مالک یا ایڈمن رہے جن کا یہ احاطہ کرتی ہے۔ اگر اسے ہٹا دیا جائے، اس کا درجہ کم کر دیا جائے یا اس کا لاگ اِن غیر فعال کر دیا جائے تو کالز اس پیغام کے ساتھ ناکام ہوتی ہیں: "جس شخص نے یہ API کلید بنائی تھی وہ اب اس کے ورک اسپیسز کا ایڈمن نہیں ہے۔ کسی موجودہ ایڈمن سے نئی کلید جاری کرنے کو کہیں۔"
- آپ صرف وہی کلیدیں دیکھ، روٹیٹ اور منسوخ کر سکتے ہیں جن کے ورک اسپیسز کے آپ خود ایڈمن ہیں۔ بہت سے کلائنٹ ورک اسپیسز والے اکاؤنٹ میں ایک کلائنٹ کا ایڈمن دوسرے کلائنٹ کی کلیدیں نہیں دیکھ سکتا۔
اگر کچھ غلط ہو جائے
- "اس API کلید کی میعاد ختم ہو چکی ہے۔ اسے سیٹنگز > ڈویلپر API کلیدیں میں روٹیٹ کریں۔": کلیدیں ایک سال چلتی ہیں۔ ڈویلپر API کلیدیں میں اس کلید پر روٹیٹ کریں پر کلک کریں (یا نئی بنائیں) اور اپنی انٹیگریشن کو اپ ڈیٹ کریں۔
- "غلط یا منسوخ شدہ API کلید": کلید منسوخ کر دی گئی، روٹیشن کی 24 گھنٹے کی مہلت ختم ہو گئی، یا یہ ادھوری کاپی ہوئی۔
- API کلید دوسری کلیدیں نہ بنا سکتی ہے، نہ روٹیٹ کر سکتی ہے نہ منسوخ؛ یہ صرف سائن اِن کیا ہوا شخص کر سکتا ہے۔
متعلقہ
23 ستمبر، 2026 کو پروڈکٹ کے مطابق جانچا گیا