API کلیدیں اور ایکسیس ٹوکنز

API کلید وہ ذریعہ ہے جس سے آپ کے پروگرام LinkHarbor API تک پہنچتے ہیں۔ یہ کسی شخص کی نہیں بلکہ ایک ورک اسپیس کی ہوتی ہے، اور بالکل وہی کر سکتی ہے جس کی آپ اسکوپس کے ذریعے اجازت دیں۔ اصل کالز کے لیے آپ کلید کو ایک کم مدتی ایکسیس ٹوکن سے بدلتے ہیں۔

#API کلیدیں کون بنا سکتا ہے؟

• ورک اسپیس کے مالکان اور ایڈمنز – ایڈیٹرز اور ناظرین کو “کال بیک اور API” کے تحت صرف “منسلک ایپس” کارڈ نظر آتا ہے
• Creator Pro سے؛ Creator Free میں کارڈ پر لکھا ہوتا ہے “API کلیدیں Creator Pro سے دستیاب ہیں۔”
• ایک وقت میں فعال: Creator Pro میں زیادہ سے زیادہ 5 کلیدیں، Creator Agency میں 20، Enterprise میں 50

حد پوری ہونے پر کلید بنانا 409 limit_reached کے ساتھ ناکام ہو جاتا ہے۔ پہلے کوئی ایسی کلید حذف کریں جس کی اب ضرورت نہیں۔

#API کلید بنائیں

1. نیویگیشن میں “کال بیک اور API” کھولیں
2. “API کلیدیں” کارڈ میں “+ نئی کلید بنائیں” پر کلک کریں
3. “نام (اختیاری)” میں ایسا نام درج کریں جس سے آپ بعد میں کلید پہچان سکیں، مثلاً “CI/CD Pipeline” یا “شاپ سنک”
4. “اسکوپس” میں ہر حصے کے لیے “پڑھنا” یا “لکھنا” چنیں
5. “کلید بنائیں” پر کلک کریں
6. “کلید کا سیکرٹ (نجی)” فوراً کاپی کریں اور کسی محفوظ جگہ رکھیں
7. ڈائیلاگ بند کریں – کلید ID آپ کو فہرست میں کسی بھی وقت مل جائے گی

“نام (اختیاری)”

زیادہ سے زیادہ 64 حروف۔ نام کے بغیر کلید فہرست میں “API کلید #ID” کے طور پر نظر آتی ہے۔

“اسکوپس”

کم از کم ایک ضروری ہے۔ “لکھنا” میں اسی حصے کا “پڑھنا” خود بخود شامل ہوتا ہے۔ اعداد و شمار اور حامیوں کی ادائیگیاں صرف پڑھنے کے لیے ہیں، ورک اسپیس ٹیمپلیٹس صرف لکھنے کے لیے۔ تمام اسکوپس کی وضاحت اسکوپس تفصیل سے میں ہے۔

“کلید کا سیکرٹ (نجی)”

lt_ سے شروع ہوتا ہے اور صرف ایک بار دکھایا جاتا ہے (“⚠️ صرف ایک بار نظر آئے گی — ابھی کاپی کریں!”)۔ LinkHarbor اس کا صرف ایک ہیش محفوظ کرتا ہے اور اسے بعد میں دوبارہ نہیں دکھا سکتا۔

“کلید ID:”

ہندسوں اور بڑے حروف A–F پر مشتمل 16 حروف، مثلاً 6F668EA6598B0692۔ یہ خفیہ نہیں ہے اور فہرست میں کاپی بٹن کے ساتھ نظر آتی ہے۔

#کلیدوں کی فہرست

ہر فعال کلید اپنا نام، اسٹیٹس “فعال”، کلید ID، اپنی اسکوپس، “بنائی گئی:” اور “آخری استعمال:” یا “ابھی تک استعمال نہیں ہوئی” دکھاتی ہے۔ آخری استعمال کا وقت کلید سے کی گئی ہر کال پر اپ ڈیٹ ہوتا ہے، زیادہ سے زیادہ منٹ میں ایک بار۔ “↺ ریفریش کریں” فہرست دوبارہ لوڈ کرتا ہے۔

#کلید کو ایکسیس ٹوکن سے بدلیں

curl -X POST https://dock.at-harbor.com/v1/token \
  -H "Content-Type: application/json" \
  -d '{"key_id":"6F668EA6598B0692","key_secret":"lt_…"}'

{ "token": "eyJhbGciOiJIUzI1NiIs…", "expires_in": 900 }

token

ایکسیس ٹوکن۔ آپ اسے ہر ریکویسٹ کے ساتھ Authorization: Bearer <token> کے طور پر بھیجتے ہیں۔

expires_in

سیکنڈز میں مدت: 900، یعنی 15 منٹ۔ کوئی ریفریش ٹوکن نہیں ہے – مدت ختم ہونے پر بس کلید ID اور سیکرٹ سے نیا ٹوکن حاصل کریں۔

ٹوکن ورک اسپیس کی نمائندگی کرتا ہے اور بالکل کلید والی اسکوپس رکھتا ہے۔ اس کا کسی شخص کی طرح کوئی رول نہیں ہوتا: جو اینڈپوائنٹس ڈیش بورڈ مالکان اور ایڈمنز کے لیے مخصوص رکھتا ہے (ممبرز، بلنگ، ڈومینز کا انتظام، ویب ہُکس، ورک اسپیس سیٹنگز) وہ API کلیدوں کے ٹوکنز کے لیے ہمیشہ مسترد ہوتے ہیں۔ استثنا مختصر لنکس اور ورک اسپیس ٹیمپلیٹس ہیں، جو متعلقہ اسکوپ کے ساتھ کام کرتے ہیں، اور read:workspaces کے ساتھ کال بیک سیکرٹس پڑھنا (سادہ متن والے سیکرٹ کے بغیر)۔

#ناکام کوششیں اور لاک

api_key_locked کی صورت میں باقی وقت details.retry_after_sec میں ہوتا ہے۔ ایک کامیاب تبادلہ کاؤنٹر کو ری سیٹ کر دیتا ہے۔

#کلید حذف کریں اور بدلیں

1. کلید کے ساتھ “حذف کریں” پر کلک کریں
2. تصدیق کے لیے DELETE ٹائپ کریں
3. “مستقل طور پر حذف کریں” پر کلک کریں

کلید فوراً کام کرنا بند کر دیتی ہے – پہلے سے جاری کیے گئے ایکسیس ٹوکنز بھی اسی لمحے سے کام نہیں کرتے اور 401 invalid_token پاتے ہیں۔ تبدیل کرنے کا کوئی بٹن نہیں ہے۔ کلید بدلنے کے لیے نئی کلید بنائیں، اپنے پروگرام کو اس پر منتقل کریں اور پھر پرانی حذف کریں۔

#جب پلان نیچے جائے

اگر ورک اسپیس Creator Free پر چلی جائے تو تمام API کلیدیں منسوخ ہو جاتی ہیں۔ اگر وہ کم کلیدوں والے پلان پر جائے تو سب سے نئی کلیدیں رہتی ہیں اور باقی منسوخ ہو جاتی ہیں۔ منسوخ کلیدیں بعد میں اپ گریڈ کرنے پر واپس نہیں آتیں – تب آپ نئی بناتے ہیں۔ مالکان کو بند کیے گئے فیچرز کی فہرست کے ساتھ ایک ای میل ملتی ہے۔ مزید منسوخی اور ڈاؤن گریڈ میں۔

#محفوظ رکھنا

• سیکرٹ صرف کسی سیکرٹس مینیجر یا انوائرنمنٹ ویری ایبلز میں رکھیں، کبھی سورس کوڈ یا Git ریپوزٹری میں نہیں
• اسے کبھی ایسے کوڈ میں استعمال نہ کریں جو براؤزر میں یا صارف کے ڈیوائس پر کسی ایپ میں چلتا ہو
• ہر ایپلیکیشن کے لیے الگ کلید بنائیں، جتنی ممکن ہو کم اسکوپس کے ساتھ
• جن کلیدوں کی اب ضرورت نہیں انہیں فوراً حذف کریں
• لیک کا شبہ ہو تو: کلید حذف کریں اور نئی بنائیں