API-nycklar
Skapa API-nyckel
Section titled “Skapa API-nyckel”POST /api/v1/api-keysSkapar en ny API-nyckel för den autentiserade användaren.
Begärans kropp
Section titled “Begärans kropp”{ "name": "My integration"}| Fält | Obligatorisk | Beskrivning |
|---|---|---|
name | Ja | Visningsnamn för nyckeln (1–100 tecken) |
{ "data": { "id": "key_uuid", "name": "My integration", "prefix": "rm_abc123", "key": "rm_abc123def456...", "created_at": "2025-09-19T15:00:00.000Z" }}Lista API-nycklar
Section titled “Lista API-nycklar”GET /api/v1/api-keysReturnerar alla API-nycklar för den autentiserade användaren. Det fullständiga nyckelvärdet returneras aldrig efter skapandet.
{ "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 } ]}Återkalla API-nyckel
Section titled “Återkalla API-nyckel”DELETE /api/v1/api-keys/:idÅterkallar permanent en API-nyckel. Förfrågningar som använder denna nyckel kommer omedelbart att misslyckas med INVALID_API_KEY.
{ "data": { "success": true }}Felkoder
Section titled “Felkoder”| Kod | HTTP-status | Betydelse |
|---|---|---|
API_KEY_NOT_FOUND | 404 | Nyckeln finns inte eller tillhör en annan användare |
ALREADY_REVOKED | 400 | Nyckeln har redan återkallats |