تصدیق کا جائزہ

یہ گائیڈ بتاتی ہے کہ ہماری API کے ساتھ تصدیق کیسے کی جائے۔ ہم کئی تصدیقی طریقوں کی حمایت کرتے ہیں:

API کلیدیں

سب سے آسان تصدیقی طریقہ API کلیدوں کا استعمال ہے۔ ہر API کلید ایک مخصوص صارف سے منسلک ہوتی ہے اور اس کی مخصوص اجازتیں ہوتی ہیں۔

// Example API Key request
const response = await fetch('https://api.example.com/data', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

OAuth 2.0

زیادہ محفوظ ایپلیکیشنز کے لیے، ہم OAuth 2.0 تصدیقی فلو کی حمایت کرتے ہیں:

1. اجازت کی درخواست: صارفین کو ہمارے authorization URL پر ری ڈائریکٹ کریں
2. صارف کی رضامندی: صارف اپنے اکاؤنٹ تک رسائی کی منظوری دیتا ہے
3. اجازتی کوڈ: ہمارا سرور ایک اجازتی کوڈ واپس کرتا ہے
4. ٹوکن کا تبادلہ: کوڈ کو ایکسیس ٹوکن سے تبدیل کریں
5. API درخواستیں: محفوظ وسائل تک رسائی کے لیے ایکسیس ٹوکن استعمال کریں

JWT ٹوکنز

تصدیق کے بعد، ہم JWT ٹوکنز جاری کرتے ہیں جن میں صارف اور اس کی اجازتوں کے بارے میں انکوڈ شدہ معلومات ہوتی ہیں۔

// Example JWT token usage
const response = await fetch('https://api.example.com/protected-resource', {
  headers: {
    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
  }
});

سیشن مینجمنٹ

سیشنز بطور ڈیفالٹ 24 گھنٹے کے لیے کارآمد رہتے ہیں۔ کسی سیشن کو ریفریش کرنے کے لیے:

const refreshResponse = await fetch('https://api.example.com/auth/refresh', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer CURRENT_REFRESH_TOKEN'
  }
});

// Parse the new tokens
const { accessToken, refreshToken } = await refreshResponse.json();

بہترین طریقے

1. API کلیدیں یا ٹوکنز کبھی کلائنٹ سائیڈ کوڈ میں محفوظ نہ کریں
2. حساس کریڈنشلز کے لیے انوائرمنٹ ویری ایبلز استعمال کریں
3. طویل مدت تک چلنے والی ایپلیکیشنز کے لیے ٹوکن ریفریش میکانزم نافذ کریں
4. ٹوکن کی میعاد ختم ہونے کے مناسب اوقات مقرر کریں
5. تمام API درخواستوں کے لیے HTTPS استعمال کریں