# Autenticación (/docs/referencia/autenticacion)



Enviá la API key completa mediante el header:

```http
Authorization: Bearer {tu-api-key}
```

La clave identifica al contribuyente y determina el ambiente. Las claves nuevas usan estos prefijos: `sk_sandbox_` para Sandbox de Sifende, `sk_test_` para pruebas con SIFEN y `sk_live_` para producción. Todas usan `https://api.sifende.com.py`. El ambiente de una clave no cambia después de crearla.

Las claves antiguas pueden tener un prefijo que no coincida con su ambiente. Verificá el ambiente en el panel; no lo deduzcas del prefijo.

## Crear y cambiar una clave [#crear-y-cambiar-una-clave]

Entrá a **API Keys → Crear API Key** en el panel, completá el nombre y elegí el ambiente. La clave completa se muestra una sola vez. Consultá [API keys](/docs/panel/api-keys) para ver los requisitos de producción, la expiración y la eliminación.

**Rotar** invalida la clave anterior al instante. Para cambiarla sin corte, creá otra, configurala en tu integración y eliminá la anterior cuando hayas verificado el cambio.

## Revocar la clave desde tu integración [#revocar-la-clave-desde-tu-integración]

Una integración que se desinstala puede darse de baja sin entrar al panel. Primero eliminá sus [webhooks](/docs/referencia/webhooks/administrar-por-api#eliminar) y después revocá la clave con la misma clave:

```bash
curl -X DELETE https://api.sifende.com.py/api/v1/contribuyente/api-key \
  -H "Authorization: Bearer $SIFENDE_API_KEY"
```

Responde `204 No Content`; desde ese momento la clave responde `401`. No se puede deshacer. Revocar la clave y eliminar webhooks funcionan aunque el plan del contribuyente ya no incluya la API de integración.

## Ejemplo [#ejemplo]

```bash
curl "https://api.sifende.com.py/api/v1/documento-electronico/status/$CDC" \
  -H "Authorization: Bearer $SIFENDE_API_KEY"
```

## Errores de autenticación [#errores-de-autenticación]

| Status             | Qué revisar                                                                                                                                                                                                                                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `401 Unauthorized` | Clave ausente, inválida, expirada o revocada. Revisá el valor completo y el prefijo `Bearer`                                                                                                                                                                                                                       |
| `403 Forbidden`    | Permisos para el recurso u operación solicitada; revisá el detalle de la respuesta. Una clave de producción recibe [`plan-operation-not-allowed`](/docs/solucion-problemas/plan-operation-not-allowed) si el plan vigente no incluye la API de integración, salvo al revocar la propia clave o eliminar un webhook |

Una clave inválida o expirada recibe:

```json
{"error": "Invalid or expired API key"}
```

Esta respuesta `401` usa el campo `error`. Los [Problem Details](/docs/referencia/errores) se identifican por su campo `type`.
