Listar API Keys

GET /api/v1/contribuyentes/:contribuyenteId/api-keys — obtené todos los API keys de un contribuyente.

GET /api/v1/contribuyentes/:contribuyenteId/api-keys

Lista todos los API keys del contribuyente. Nunca devuelve la clave en texto plano — solo el prefijo identificador.

Autenticación

Authorization: Bearer {jwt} — JWT de Keycloak. El usuario debe ser propietario del contribuyente.

Path parameters

Parámetro	Tipo	Descripción
`contribuyenteId`	`integer`	ID interno del contribuyente

Respuesta exitosa

Status: 200 OK

{
  "status": "success",
  "payload": [
    {
      "apiKeyId": 42,
      "nombre": "Integración ERP Producción",
      "keyPrefix": "sk_live_8f3a9c2e",
      "estaActivo": true,
      "ultimoUso": "2026-04-27T09:15:42",
      "expiraEn": "2027-01-01T00:00:00",
      "fechaCreacion": "2026-01-15T11:00:00"
    },
    {
      "apiKeyId": 43,
      "nombre": "Pruebas locales",
      "keyPrefix": "sk_test_5b7d1e9f",
      "estaActivo": true,
      "ultimoUso": null,
      "expiraEn": null,
      "fechaCreacion": "2026-03-20T16:45:00"
    }
  ]
}

Campos del ApiKeyDTO

Campo	Tipo	Descripción
`apiKeyId`	`integer`	ID interno de la clave
`nombre`	`string`	Nombre descriptivo asignado al crearla
`keyPrefix`	`string`	Primeros caracteres de la clave (para identificación visual)
`estaActivo`	`boolean`	`true` si la clave acepta requests
`ultimoUso`	`datetime\|null`	Última vez que se autenticó con esta clave
`expiraEn`	`datetime\|null`	Fecha de expiración. `null` = no expira
`fechaCreacion`	`datetime`	Fecha de creación de la clave

Errores

Status	Tipo	Descripción
401	—	JWT inválido, expirado o ausente
403	`access-denied`	El usuario no es propietario del contribuyente
404	`contribuyente-not-found`	Contribuyente no existe

Ejemplo

curl https://api.sifende.com.py/api/v1/contribuyentes/42/api-keys \
  -H "Authorization: Bearer $JWT"