logo

Seznam pro vývojáře

Spravovat služby

Přihlášení přes Seznam

Seznam pro vývojářePřihlášení přes Seznam

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:

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:

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:

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