Applicant Magic Link ile Kimlik Doğrulama

Bu endpoint, geleneksel bir şifre olmadan giriş yapmak için kullanılabilecek güvenli bir applicant magic link oluşturmanıza olanak tanır. Link belirli bir süre aktif kalır ve kullanıcı dostu bir deneyim sunar.

---

HTTP İstek Detayları

• Yöntem: POST
• URL:
  https://api.vinter.me/api/v1/Auth/CreateApplicantMagicLink

---

İstek Başlıkları

Başlık Adı	Açıklama	Örnek Değer
X-Api-Key	Organizasyon kimlik doğrulama API anahtarı.	api_key
Content-Type	İstek gövdesinin medya tipini belirtir.	application/json

---

İstek Gövdesi

İstek gövdesinde şu alanlar yer almalıdır:

Parametre Adı	Tür	Gerekli	Açıklama
firstName	String	Evet	Kullanıcının adı.
lastName	String	Evet	Kullanıcının soyadı.
email	String	Evet	Kullanıcının e-posta adresi.
phone	String	Evet	Kullanıcının telefon numarası.
languageCode	String	Evet	İletişim için tercih edilen dil.
mailPermission	Boolean	Evet	E-posta bildirimleri alma izni.
positionId	String	Evet	Pozisyon id'si.

Örnek İstek Gövdesi

{
  "firstName": "Musa",
  "lastName": "ERTEK",
  "email": "[email protected]",
  "phone": "+905555555555",
  "languageCode": "tr-TR",
  "mailPermission": true,
  "positionId": "727df810-bb41-4751-98c8-e8f81c5a69f2"
}

---

Yanıt Formatı

İstek sonucunda, yeni bir MagicLink döndürülür. Bu MagicLink belirli bir süre boyunca geçerlidir.

Örnek Yanıt Gövdesi

{
  "Data": {
    "MagicLink": "https://applicant.vinter.me/loginWithKey?apiKey=BFflidn6j2yTa7ul2pLmpw==:wQLz9jG/T0j6nNHfMCnBMJrekhDaYj6TG5lQ+ikHDcyXcbODkg0wo8wmaFt6isAyzjQWxpRS7P569Cz/GT7sDBKSLy1O03Hca/aaR9ilY20znmKtDCeSGoIm0qUf88s9M+NDQJ0EiF37A+wxmUSj0Es2LZgsvvUVgQzxRvqZnTUzLuD6FRvUV0SGyFkdWN5udZPcbRD3g3ilrtc/60BKhGsK1R81ogCO/xUj7RAH6cNkcbSatLry/4f5+fMRi6NQ"
  },
  "Success": true,
  "Message": null,
  "IsResourceKey": true
}

Detaylı Alan Açıklamaları

• MagicLink:
  Giriş yapmak için kullanılabilecek güvenli bir link. Belirlenen süre kadar geçerlidir.

• Success:
  İsteğin başarıyla işlenip işlenmediğini belirtir.

• Message:
  Ek bilgi veya hata mesajları.

• IsResourceKey:
  Yanıtın kaynak anahtarı içerip içermediğini belirten bir bayrak.

---

Kullanım Alanları

• Şifresiz Giriş:
  Kullanıcılara, şifreleri hatırlamalarına gerek kalmadan hızlı ve güvenli bir giriş yöntemi sunar.

• Güvenli Erişim Kontrolü:
  Sadece yetkili kişilerin geçerli bir magic link oluşturmasını sağlar.

• Kolaylaştırılmış Kayıt Süreci:
  Yeni kullanıcılar, geleneksel kayıt süreçlerine gerek kalmadan hesaplarını kolayca oluşturup giriş yapabilir.