Funkcionalita narozenin slouží k oznamování, kdy má kdo narozeniny. Vyhodnocení narozenin probíhá na základě data narození, který si každý uživatel ukldádá sám na pomocí příkazu. Samotné oznámení o narozeninách je možné provést pomocí příkazu, nebo počkat na provedení naplánované úlohy. Ve výchozí konfiguraci se naplánovaná úloha spouští každých 24 hodin (v 8:00 AM).
/narozeniny a jsou integrovány jako "slash commands".
/narozeniny pridat {kdy}
- Uložení data narození k uživateli, který použil příkaz. Datum narození nelze přiřadit jinému uživateli.
kdy (DateTime) -
Datum narození. Pokud si nepřejete uložit věk, pak zadejte rok 0001/narozeniny pridat 1997-06-05/narozeniny mam
- Zjištění, zda má uživatel uloženo datum narození. Není možné zjistit, zda má jiný uživatelů uloženo datum narození.
/narozeniny smazat
- Smazání data narození uživatele. Není možné smazat datum narození jinému uživateli.
/narozeniny dnes
- Zjišťění, kdo má dnes narozeniny.
Oprávněné osoby jsou pomocí soukromé administrace schopni pouze zjistit, zda uživatel má, nebo nemá uložené narozeniny. Není možné zjistit konkrétní datum.
Po schválení přístupu (a případném přidělení API klíče) mohou aplikace třetích stran získat informace o aktuálním stavu narozenin pomocí
endpointu GET /api/user/birthday/today. Endpoint vrací pouze naformátovaný řetězec.