⚙️ Groups Endpoint

Úvod do Groups

Endpoint groups vám umožňuje spravovat skupiny v systému Daktela. Jedná se o základní konstrukt pro organizaci a klasifikaci entit v rámci vašeho API. Skupiny slouží jako kolekce pro logické seskupování prvků.

HTTP Metody

Endpoint groups podporuje následující HTTP metody:

🔴 GET - Načítání seznamu skupin a jejich dat
🟢 POST - Vytváření nových skupin nebo jejich modifikace

Dostupná Pole

V dokumentaci nejsou specifikována konkrétní pole pro tento endpoint.

Pro detailní informace o dostupných polích kontaktujte administrátora API nebo si prostudujte pokročilou dokumentaci v centrálním repozitáři.

Příklady Použití

GET Request - Načtení skupin

// GET request - Načtení seznamu skupin
$result = $client->get('groups');

// Zpracování výsledku
if (empty($result['error'])) {
    $groups = $result['result']['data'];
    $total = $result['result']['total'];

    foreach ($groups as $group) {
        // Zpracování každé skupiny
        echo "Skupina: " . json_encode($group) . "\n";
    }
} else {
    echo "Chyba: " . json_encode($result['error']) . "\n";
}
                    

POST Request - Vytvoření skupiny

// POST request - Vytvoření nové skupiny
$result = $client->post('groups', [
    'field' => 'value'
    // Doplnit další požadovaná pole dle specifikace
]);

// Kontrola výsledku
if (empty($result['error'])) {
    echo "Skupina vytvořena úspěšně!";
    echo json_encode($result['result']);
} else {
    echo "Chyba při vytváření: " . json_encode($result['error']);
}
                    

Příklad Odpovědi

⚙ Standardní formát odpovědi

Všechny odpovědi z groups endpointu jsou vráceny v jednotném JSON formátu:

{
    "error": [],
    "result": {
        "data": [],
        "total": 0
    },
    "_serverTime": "2025-11-20 14:18:29",
    "_time": "2025-11-20 14:18:29",
    "_timezone": "Europe/Prague"
}
                        

Popis polí odpovědi:

error - Pole obsahující chyby (prázdné pokud vše v pořádku)
result - Objekt obsahující data odpovědi
result.data - Pole se skupinami
result.total - Celkový počet skupin
_serverTime - Čas zpracování na serveru
_time - Čas vykonání requestu
_timezone - Časová zóna serveru

Důležité Poznámky

⚡ Error Handling: Vždy kontrolujte pole error v odpovědi. Pokud obsahuje jakékoliv údaje, došlo k chybě.

⚡ Časy a Časové Zóny: Všechny časy jsou vráceny v UTC. Pole _timezone udává server timezone.

⚡ Autentizace: Pro přístup k tomuto endpointu je vyžadován validní access token vložený do header Authorization.

⚓ Mapa pokladů

Groups Endpoint Dokumentace