# Autenticación y llaves API

Para usar la API necesita una llave (API key). La llave se envía en cada solicitud como un header de autorización.

## 1. Obtener su llave API

Vaya a [Llaves API](/api_keys) en su panel. Ingrese un nombre descriptivo (ej. "Mi app de compliance") y haga clic en crear.

Importante:

La llave completa solo se muestra **una vez** al momento de crearla. Cópiela y guárdela en un lugar seguro. Si la pierde, deberá crear una nueva.

## 2. Enviar la llave en cada solicitud

Incluya la llave en el header `Authorization` con el prefijo `Bearer`:

```
curl 'https://api.panadata.net/v4/panama/entidades?nombre=panadata' \
  --header 'Authorization: Bearer pk_su_llave_aqui'
```

## 3. Verificar el servicio y su llave

Primero pruebe con el endpoint de salud (no consume saldo ni requiere autenticación):

```
curl 'https://api.panadata.net/health'
```

Si recibe un JSON como `{"status":"ok","service":"panadata-api"}`, el servicio está disponible. Luego pruebe una búsqueda autenticada con su llave:

```
curl 'https://api.panadata.net/v4/panama/entidades?nombre=banco' \
  --header 'Authorization: Bearer pk_su_llave_aqui'
```

## Errores comunes

`401 Unauthorized`

No se envió el header Authorization.

`403 Forbidden`

La llave fue rechazada por la capa de autenticación.

`402 Payment Required`

No tiene saldo prepago suficiente. [Recargue saldo](/credits) para continuar.

Siguiente: [Tu primera consulta →](/docs/guias/primera-consulta)