Autenticação

API Keys

Todas as requisições à API do Tartini são autenticadas via API key. Chaves são geradas no Dashboard e associadas a uma empresa.

pyp_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4

Todas as chaves começam com o prefixo pyp_live_ seguido de 48 caracteres hexadecimais.

Inclua sua API key no header Authorization de todas as requisições:

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

Nunca exponha sua API key em código frontend, repositórios públicos ou logs. Trate-a como uma senha.

Além da chave ser válida, a API verifica se a assinatura da empresa está ativa. Empresas com assinatura inativa recebem:

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

Código	Erro	Causa
`401`	`Missing API key`	Header `Authorization` ausente
`401`	`Invalid API key format`	Formato incorreto (deve ser `Bearer pyp_live_...`)
`401`	`Invalid or expired API key`	Chave inexistente ou revogada
`403`	`SubscriptionInactive`	Assinatura da empresa inativa

Use variáveis de ambiente

Nunca coloque a API key diretamente no código. Use variáveis de ambiente:

export SANTALK_API_KEY="pyp_live_SUA_API_KEY"

const apiKey = process.env.SANTALK_API_KEY;

Rotacione chaves periodicamente

Crie uma nova chave no Dashboard, atualize seus sistemas e revogue a chave antiga.

Use chaves diferentes por ambiente

Mantenha chaves separadas para desenvolvimento, staging e produção.