Autenticación

API Keys

Todas las solicitudes a la API de Tartini se autentican mediante API key. Las claves se generan en el Dashboard y se asocian a una empresa.

pyp_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4

Todas las claves empiezan con el prefijo pyp_live_ seguido de 48 caracteres hexadecimales.

Incluye tu API key en el header Authorization de todas las solicitudes:

curl -X GET https://api-talk.saninternet.com/v1/api/status \
  -H "Authorization: Bearer pyp_live_SUA_API_KEY"

Nunca expongas tu API key en código frontend, repositorios públicos o logs. Trátala como una contraseña.

Además de que la clave sea válida, la API verifica que la suscripción de la empresa esté activa. Las empresas con suscripción inactiva reciben:

{
  "statusCode": 403,
  "error": "SubscriptionInactive",
  "message": "Sua assinatura não está ativa",
  "subscriptionStatus": "CANCELLED"
}

Código	Error	Causa
`401`	`Missing API key`	Header `Authorization` ausente
`401`	`Invalid API key format`	Formato incorrecto (debe ser `Bearer pyp_live_...`)
`401`	`Invalid or expired API key`	Clave inexistente o revocada
`403`	`SubscriptionInactive`	Suscripción de la empresa inactiva

Usa variables de entorno

Nunca coloques la API key directamente en el código. Usa variables de entorno:

export SANTALK_API_KEY="pyp_live_SUA_API_KEY"

const apiKey = process.env.SANTALK_API_KEY;

Rota las claves periódicamente

Crea una nueva clave en el Dashboard, actualiza tus sistemas y revoca la clave antigua.

Usa claves diferentes por entorno

Mantén claves separadas para desarrollo, staging y producción.