Autenticación

Todas las solicitudes API de Poomi requieren autenticación mediante una API Key enviada en el encabezado Authorization.

Método de Autenticación

Incluye tu API Key en el encabezado Authorization usando el esquema Bearer:

curl https://www.poomi.pet/api/v1/{endpoint} \
  -H "Authorization: Bearer pk_your_api_key_here"

pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Las Keys usan el prefijo pk_ seguido de un NanoID de 32 caracteres.

Estado HTTP	Código de Error	Descripción
401	`UNAUTHORIZED`	Encabezado Authorization faltante o inválido
401	`INVALID_KEY`	La API Key no existe
403	`KEY_DISABLED`	La API Key ha sido deshabilitada
403	`KEY_REVOKED`	La API Key ha sido revocada
403	`KEY_EXPIRED`	La API Key ha expirado

{
  "success": false,
  "error": {
    "code": "INVALID_KEY",
    "message": "Invalid API key"
  }
}

Usa variables de entorno — Nunca codifiques API Keys directamente en el código fuente
Solo del lado del servidor — Haz llamadas API desde tu backend, nunca expongas Keys en código del cliente
Separa entornos — Usa Keys diferentes para desarrollo y producción
Revoca Keys comprometidas — Si una Key queda expuesta, revócala inmediatamente en la Consola de Desarrollador