API systému DOSYS
Přehled
Docházkový systém DOSYS obsahuje kanály API, umožňující přístup k datům docházky a to jak pro čtení, tak i v některých případech pro zápis dat do docházkového systému. Data jsou až na výjimky předávána ve formátu JSON se znakovou sadou UTF8.
Ověření, zabezpečení
Ověření všech API kanálů je pomocí Basic authentication, jako přihlašovací jméno a heslo lze použít heslo uživatele systému DOSYS který má povolena přístupová práva k API.
Seznam přístupových bodů
| URL api | Popis | Metody | |
|---|---|---|---|
| Přístup k datům docházkového systému | |||
| ?doc=api/employee | Přístup k datům zaměstnance. | GET, POST, PATCH | |
| ?doc=api/attendance | Docházka jednotlivých zaměstnanců za zadané období po dnech. Údaje odpovídají sestavě výkaz odpracovaného času. | GET | |
| Export dat do systému JOBKA | |||
| ?doc=api/jobka/days | Denní export dat pro systém JOBKA. | GET | |
| ?doc=api/jobka/months | Měsíční export dat pro systém JOBKA. | GET | |
Typy parametrů
| Typ | Popis | Příklady |
|---|---|---|
| date | Datum ve formátu yyyy-MM-dd. | 2023-01-14 |
| stringList | Seznam hodnot, oddělených čárkou. Pokud seznam není uveden a ukončen hranatou závorkou, je zpracován jako jedna hodnota. | 745 [745,451,774] |