Elenco dei gruppi

Restituisce i gruppi con cui organizzi i tuoi domini.

• Metodo: GET
• Indirizzo: https://console.icbs.it/api/v1/groups
• Permesso: Gruppi — lettura

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
type	query	no	Tipo di gruppo. Se omesso vale il tipo predefinito.

Esempio di richiesta

curl -H "Authorization: Bearer $ICBS_API_KEY" \
  https://console.icbs.it/api/v1/groups

Esempio di risposta

{
  "data": [
    { "id": 12, "name": "Clienti", "comment": "Domini dei clienti attivi", "type": "domain" },
    { "id": 13, "name": "Interni", "comment": null, "type": "domain" }
  ]
}

Campi della risposta

Campo	Descrizione
id	Identificativo del gruppo, da usare per modificarlo o eliminarlo.
name	Nome del gruppo.
comment	Descrizione libera, null se non impostata.
type	Tipo di gruppo.

Possibili errori

Codice	Causa
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso Gruppi — lettura.
429	Superato il limite di richieste.