Scopes
Když třetí strana v rámci Přihlášení přes Seznam přesměrovává uživatele na přihlašovací obrazovku, kromě své identifikace (client_id
) musí také specifikovat, o která uživatelská data má zájem. K tomu slouží parametr scope
. V něm je nutné zadat jedno či více klíčových slov (oddělených čárkou); uživatel má následně možnost některé tyto scopes odmítnout.
Podle toho, které scopes byly uživatelem odsouhlaseny, pak následné volání /api/v1/user
vrátí různá data.
identity
Scope identity
je povinný a uživatel jej nesmí odmítnout. Díky němu budou v odpovědi na /api/v1/user
tyto položky:
oauth_user_id
je unikátní trvalý identifikátor uživatelského účtuusername
je část uživatelského jména (tj. e-mailové adresy) před zavináčemdomain
je část uživatelského jména (tj. e-mailové adresy) za zavináčemfirstname
je křestní jméno, pokud jej uživatel vyplnillastname
je příjmení, pokud jej uživatel vyplnil
contact-phone
Přidáním hodnoty contact-phone
po uživateli vyžadujeme hodnotu jeho kontaktního telefonního čísla. V odpovědi na /api/v1/user
pak přibude:
contact_phone
(jen pokud uživatel kontaktní telefon nastavil a ověřil, jinaknull
)
avatar
Přidáním hodnoty avatar
po uživateli vyžadujeme jeho profilový obrázek. V odpovědi na /api/v1/user
pak přibude:
avatar_url
– adresa k obrázku
Relevantní URL bude vráceno i pro ty uživatele, kteří si žádný obrázek nenastavili. V tomto případě bude obsahovat automaticky generovaný obrázek s iniciálami uživatele (ve formátu SVG). Rozměry obrázku lze ve všech případech konkretizovat zadáním čísla za lomítko na konec URL, např. ${avatar_url}/64