Restituisce lo stato della chiave usata per la chiamata: quali permessi ha e su quali domini può agire.
È la prima chiamata da fare quando integri l'API, e la prima da rifare quando qualcosa smette di funzionare: distingue subito una chiave revocata da un permesso mancante.
GEThttps://console.icbs.it/api/v1/meNessuno.
curl -H "Authorization: Bearer $ICBS_API_KEY" \
https://console.icbs.it/api/v1/me
{
"account": { "id": 1042 },
"key": {
"id": 7,
"name": "deploy CI",
"prefix": "a1b2c3d4e5f6",
"createdAt": "2026-08-05T09:14:22.000Z",
"expiresAt": "2027-08-05T09:14:22.000Z"
},
"scopes": ["dns:read", "dns:write"],
"domains": {
"restricted": true,
"ids": [318, 942]
}
}
| Campo | Descrizione |
|---|---|
account.id | Identificativo dell'account su cui opera la chiave. |
key.name | Il nome che hai dato alla chiave alla creazione. |
key.prefix | La parte iniziale della chiave, l'unica visibile dopo la creazione. Serve a riconoscere quale chiave stai usando senza rivelarla. |
key.expiresAt | Data di scadenza, oppure null se la chiave non scade. |
scopes | I permessi effettivi in questo momento. Possono essere meno di quelli scelti alla creazione: se chi ha creato la chiave ha perso i permessi di modifica, quelli di scrittura spariscono da qui. |
domains.restricted | true se la chiave è limitata ad alcuni domini, false se vede tutti quelli dell'account. |
domains.ids | Gli identificativi dei domini accessibili, presente solo se restricted è true. |
| Codice | Causa |
|---|---|
401 | Chiave assente, non valida, scaduta o revocata. |
429 | Superato il limite di richieste. |
Se questa chiamata risponde 200 ma un'altra risponde 403, il problema non è la chiave ma il permesso: confronta scopes con quello richiesto dalla chiamata che fallisce.