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 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.

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'

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'

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 para continuar.