Přihlášení přes Seznam – Seznam pro vývojáře

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 účtu
username je část uživatelského jména (tj. e-mailové adresy) před zavináčem
domain je část uživatelského jména (tj. e-mailové adresy) za zavináčem
firstname je křestní jméno, pokud jej uživatel vyplnil
lastname 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, jinak null)

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