Autenticação

​

Visão Geral

​

OAuth 2.0 com JWT (Recomendado)

​

Como obter suas credenciais OAuth

• client_id: identificador único da sua aplicação
• client_secret: chave secreta para autenticação

​

Como obter o token

curl -X POST https://auth-sms.pontaltech.com.br/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -u "SEU_CLIENT_ID:SEU_CLIENT_SECRET" \
  -d "grant_type=client_credentials&scope=pontaltech-api/sms"

​

Resposta do token

{
  "access_token": "eyJraWQiOiJ...",
  "expires_in": 3600,
  "token_type": "Bearer"
}

​

Usando o token nas requisições

Authorization: Bearer eyJraWQiOiJ...

​

Exemplo completo

# 1. Obter o token
TOKEN=$(curl -s -X POST https://auth-sms.pontaltech.com.br/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -u "SEU_CLIENT_ID:SEU_CLIENT_SECRET" \
  -d "grant_type=client_credentials&scope=pontaltech-api/sms" \
  | jq -r '.access_token')

# 2. Usar o token na API
curl -X POST https://pointer-sms-api.pontaltech.com.br/v1/message \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"to": "11999999999", "message": "Teste"}]}'

​

Expiração e renovação

• O token expira após 1 hora (3600 segundos).
• Não existe refresh token neste fluxo. Quando o token expirar, solicite um novo com as mesmas credenciais.
• Boas práticas: armazene o token em cache e renove antes de expirar (ex: a cada 50 minutos).

​

Erros de autenticação OAuth

​

Basic Auth (Legado)

​

Como funciona

• slug como usuário
• apiKey como senha

slug:apiKey → Base64 → credenciaisGeradas

Authorization: Basic <credenciaisGeradas>

​

Exemplo

echo -n "meusite:abc123" | base64

bWV1c2l0ZTphYmMxMjM=

Authorization: Basic bWV1c2l0ZTphYmMxMjM=

​

Como testar no Postman ou Insomnia

​

OAuth 2.0

1. Vá até a aba Authorization
2. Selecione o tipo: OAuth 2.0
3. Configure:
   • Grant Type: Client Credentials
   • Access Token URL: https://auth-sms.pontaltech.com.br/oauth2/token
   • Client ID: seu client_id
   • Client Secret: seu client_secret
   • Scope: pontaltech-api/sms
   • Client Authentication: Send as Basic Auth header
4. Clique em Get New Access Token

​

Basic Auth

1. Vá até a aba Authorization
2. Selecione o tipo: Basic Auth
3. Preencha:
   • Username: slug
   • Password: apiKey
4. A ferramenta irá gerar automaticamente o header Authorization com o valor Basic <base64(slug:apiKey)>

​

Observações

• Todas as rotas protegidas exigem um dos métodos de autenticação acima.
• Para novas integrações, utilize OAuth 2.0 (JWT) — mais seguro e com controle granular de escopos.
• Não compartilhe suas credenciais (apiKey, client_id ou client_secret).
• Credenciais inválidas retornarão erro 401 (Unauthorized).
• Para solicitar credenciais OAuth, entre em contato com o suporte Pontaltech.