smskitdocs

Auth

Troque sua chave de API pelo token que as outras rotas pedem.

Base https://api.smskit.dev · Autorização Bearer <token> · como obter o token

POST/v1/auth/token

Trocar a chave de API por um token Bearer de 48h

Envie a chave em X-API-Key (ou no corpo como api_key). O token retornado vale 48 horas e é o único credencial usado nas demais rotas; a chave nunca trafega em cada requisição. Chaves sk_test_ geram tokens de modo de teste: mesmas rotas, respostas idênticas, nada é cobrado nem enviado.

Parâmetros

x-api-keystringheader

Corpo · TokenRequest (opcional)

api_keystring | null

Respostas

  • 200Objeto TokenResponseaccess_token, expires_at, expires_in, mode, token_type, workspace_id
  • 401Credencial ausente, inválida ou expirada
  • 422validation_error
  • 429rate_limited — respeite Retry-After
curl -X POST https://api.smskit.dev/v1/auth/token \
  -H "X-API-Key: $SMSKIT_KEY"
200 · resposta
{
  "access_token": "smt_…",
  "expires_at": "2026-09-13T14:03:00Z",
  "expires_in": 172800,
  "mode": "live",
  "workspace_id": "ws_3h7k9d",
  "token_type": "bearer"
}