Ana içeriğe geç

GetTokenFromUserInfo

Çağıranın Emakin oturum açma kimliği yerine kullanıcı profili bilgilerine sahip olduğu ve kullanıcıyı otomatik olarak oluşturması gerekebileceği durumlarda bu uç noktayı kullanın.

Kullanıcı bilgilerine göre bir kimlik doğrulama belirteci oluşturur. Kullanıcı bulunamazsa ve oturum açma sağlayıcısı için otomatik kayıt etkinse kullanıcı otomatik olarak oluşturulur ve yeni kaydedilen kullanıcı için bir kimlik doğrulama belirteci döndürülür. Aksi takdirde yöntem, önceden kaydedilmiş kullanıcı için bir kimlik doğrulama belirteci döndürür.

Info

Oluşturulan belirteç yalnızca oturum açma amacıyla kullanılır ve oturum belirteci olarak kullanılamaz. Kullanıcıların kimliğini doğrulamak için bu belirteci auth parametresine iletebilirsiniz; sistem kullanıcı için yeni bir oturum belirteci oluşturur.

Gerekli Kapsam

login

Parametreler

Parametre Adı Açıklama
apiKey Çağıran sistemi kimlik doğrulaması ve yetkilendirmesi için kullanılan benzersiz bir anahtar.
userInfo Kullanıcı bilgileri.

Kullanıcı Bilgileri Parametresi

Kullanıcı bilgisi parametresi, aşağıdaki alanları içerebilen bir JSON nesnesidir:

Alan Adı Açıklama
id Kullanıcının benzersiz tanımlayıcısı. Gerekli.
providerName Oturum açma sağlayıcısının adı. Gerekli.
name Kullanıcının tam adı. Gerekli.
email Kullanıcının e-posta adresi.
firstname Kullanıcının adı.
lastname Kullanıcının soyadı.
language Kullanıcının tercih ettiği dil.
avatar Avatarın URL'leri. Ayrıntılara bakın.
otherProperties Kullanıcının diğer özellikleri. Ayrıntılara bakın.

Diğer Özellikler

Diğer özellikler nesnesi doğrudan Person tablosuyla eşlenir. Örneğin, Person tablosunda bir Gender alanınız varsa ilgili değer, diğer özellikler nesnesinde aşağıdaki gibi belirtilebilir:

1
2
3
4
5
{
    "otherProperties": {
        "gender": "M"
    }
}

Avatar

Avatar URL'leri aşağıdaki alanları içeren bir JSON nesnesi olarak sağlanmalıdır:

Alan Adı Açıklama
small Küçük boyutlu avatarın URL'si.
normal Normal boyutlu avatarın URL'si.
large Büyük boyutlu avatarın URL'si.

Örnek Çağrı

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
POST https://mydomain.emakin.com/rest/v1/getTokenFromUserInfo

{
     "apiKey": "xxxx",
     "userInfo": {
        "logonProvider": "LinkedIn",
        "id": "wcomx2h3jd",
        "name": "John Doe",
        "email": "[email protected]"
     }
}

1
2
3
4
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

"41AA3CE3CAFB..............BF8114"