logo

Seznam pro vývojáře

Spravovat služby

Přihlášení přes Seznam

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

This page in English 🇬🇧

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

adulthood

Přidáním hodnoty adulthood vyžadujeme předání informace o zletilosti uživatele. V odpovědi na /api/v1/user pak přibude:

Hodnota true se vrací pro uživatele, kteří mají nastavené a ověřené datum narození, v den přihlášení staré alespoň 18 let.
Hodnota false se vrací pro uživatele, kteří nemají nastavené datum narození nebo je datum narození neověřené nebo nedosáhli zletilosti.
Předání informace o zletilosti není pro uživatele volitelné, je proto vhodné, abyste scope využili jen v případě, že je pro vás tato informace vzhledem k vaší činnosti nezbytná.

birthday

Přidáním hodnoty birthday po uživateli vyžadujeme jeho datum narození. V odpovědi na /api/v1/user pak přibude:

gender

Přidáním hodnoty gender po uživateli vyžadujeme informaci o jeho pohlaví. V odpovědi na /api/v1/user pak přibude: