Chiavi API

Crea chiave API

POST /api/v1/api-keys

Crea una nuova chiave API per l’utente autenticato.

Corpo della richiesta

{
  "name": "My integration"
}

Campo	Obbligatorio	Descrizione
`name`	Sì	Nome visualizzato per la chiave (1–100 caratteri)

Risposta

{
  "data": {
    "id": "key_uuid",
    "name": "My integration",
    "prefix": "rm_abc123",
    "key": "rm_abc123def456...",
    "created_at": "2025-09-19T15:00:00.000Z"
  }
}

Elenca chiavi API

GET /api/v1/api-keys

Restituisce tutte le chiavi API per l’utente autenticato. Il valore completo della chiave non viene mai restituito dopo la creazione.

Risposta

{
  "data": [
    {
      "id": "key_uuid",
      "name": "My integration",
      "prefix": "rm_abc123",
      "created_at": "2025-09-19T15:00:00.000Z",
      "last_used_at": "2025-09-20T10:30:00.000Z",
      "is_revoked": false
    }
  ]
}

Revoca chiave API

DELETE /api/v1/api-keys/:id

Revoca permanentemente una chiave API. Le richieste che utilizzano questa chiave falliranno immediatamente con INVALID_API_KEY.

Risposta

{
  "data": { "success": true }
}

Codici di errore

Codice	Stato HTTP	Significato
`API_KEY_NOT_FOUND`	404	La chiave non esiste o appartiene a un altro utente
`ALREADY_REVOKED`	400	La chiave era già stata revocata