Zavoláním server vytvoří session, pod kterou pak probíhá další komunikace.
V případě autorizace prosím použít HTTPS!
Přihlášení je možné plain heslem (pwd) či hashem (pwd_hash), hash je poslán v odpovědi při úspěšné autorizaci plain heslem a má platnost 180 dní.
Hodnotu 'pwd_hash' je vhodné ukládat na zařízení a posílat v případě vypršení platnosti session.
URL
/api/rest/user/auth
Povolené HTTP metody: POST
Test
Příklady
Přihlášení username + hash
{
"username": "tester",
"pwd_hash": "uUM3PfkWReUlvX1eC0agt5MYFzur1ObHig3skuBT5vPvfG60p2h0MMOfW5kM"
}
test
Vstupní parametry
| parametr |
popis |
info |
další informace |
| username | Uživatelské jméno nebo email | | |
| pwd | Heslo | | |
| pwd_hash | Hash místo hesla. Nelze kombinovat s pwd, prioritu má vždy pwd. | | |
| device_id | ID zařízení | | | Formát REGEX | ^.{4,100}$ | | Datový typ | STRING |
|
| device_platform | Platforma OS zažízení | | | Datový typ | ENUM | | Povolené hodnoty | ios android windows other |
|
Výstupní pole
| pole |
popis |
| session_id | Session ID |
| secret_key | Klíč pro hashování/podpis požadavků, je unikátní pro každou session |
| authmode | Druh použité autorizace |
| expires | Expirace session (UTC timestamp) |
| user | |
| user:uid | |
| user:username | |
| user:email | |
| user:pwd_hash | Posláno pouze v případě authmode=pwd. Autorizační hash platný 180 dní. |
| user:avatar_120x120 | URL avataru (120x120) |
| user:is_seller | Je prodejce |
| user:url_profile | URL profilu |
| seller | |
| seller:url_shop | URL obchodu |
| seller:fler_rank | Fler rank |
| connected_accounts | Propojené účty |
| connected_accounts:uid | UID účtu |
| connected_accounts:username | |
| connected_accounts:avatar_120x120 | |
| connected_accounts:url_shop | |
| connected_accounts:url_profile | |
| connected_accounts:is_seller | |