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ının otomatik olarak oluşturulmasının gerekebileceği durumlarda bu uç noktayı kullanın.

Kullanıcı bilgilerine dayalı olarak 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 kimlik doğrulama belirteci döndürülür. Aksi takdirde yöntem, önceden kaydedilmiş kullanıcı için 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 olarak geçirebilirsiniz; sistem kullanıcı için yeni bir oturum belirteci oluşturur.

Gerekli Kapsam

oturum açma

Parametreler

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

Kullanıcı Bilgileri Parametresi

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

Alan Adı Açıklama
id Kullanıcının benzersiz tanımlayıcısı. Zorunludur.
providerName Oturum açma sağlayıcısının adı. Zorunludur.
name Kullanıcının tam adı. Zorunludur.
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 URL'leri. Ayrıntılar için lütfen bakın.
otherProperties Kullanıcının diğer özellikleri. Ayrıntılar için lütfen 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"