Salta ai contenuti

Endpoint delle chiavi API

Endpoint per gestire le tue chiavi API. Tutti i percorsi si trovano su https://api.recordmeeting.com e richiedono una chiave API. Vedi Autenticazione.

La tua prima chiave deve essere creata nell’app, in Impostazioni ➤ Chiavi API. Vedi Guida utente ➤ Chiavi API.

POST /v1/api-keys

Crea una nuova chiave API per il tuo account.

{
"name": "My integration"
}
CampoObbligatorioDescrizione
nameSìNome visualizzato per la chiave (da 1 a 100 caratteri)

201 Created

{
"data": {
"id": "key_uuid",
"name": "My integration",
"prefix": "sk_rm_a1b2c3",
"key": "sk_rm_a1b2c3d4e5f6...",
"created_at": "2026-09-19T15:00:00.000Z"
}
}

Errori: 400 VALIDATION_ERROR.


GET /v1/api-keys

Restituisce le chiavi API del tuo account. Il valore completo della chiave non viene mai restituito dopo la creazione.

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

last_used_at è null per una chiave che non è mai stata usata.


DELETE /v1/api-keys/:id

Revoca permanentemente una chiave API. Da quel momento, le richieste che usano la chiave falliscono con 401 INVALID_API_KEY. Questa operazione non può essere annullata.

204 No Content con un corpo vuoto.

CodiceStato HTTPSignificato
API_KEY_NOT_FOUND404La chiave non esiste o appartiene a un altro account
ALREADY_REVOKED400La chiave è già stata revocata