Escolha um idioma

Chaves de API e segurança

Escopos, listas de IPs permitidos, limites diários de gasto, expiração, rotação sem interrupção e o que fazer se uma chave vazar.

Nesta página
  1. Formato da chave
  2. Limite o que cada chave pode fazer
  3. Confirmar mudanças sensíveis
  4. Rotação sem interrupção
  5. Revogar
  6. Se uma chave vazou
  7. O que registramos
  8. Nunca pelo navegador

Uma chave de API pode fazer tudo o que seus escopos permitem, pagando com seu saldo. Trate-a como uma senha.

Formato da chave

As chaves são sgk_ seguido de 40 letras e números. O SmsGrab guarda só uma impressão digital de cada chave, então ela é mostrada uma vez, quando você a cria ou rotaciona, e nunca mais. Na sua conta você vê apenas o começo e os quatro últimos caracteres.

Limite o que cada chave pode fazer

Ao criar ou editar uma chave, você pode restringi-la:

Configuração O que faz
Escopos read para saldo, catálogo, preços, ativações e uso; read e purchase para também comprar, cancelar e finalizar
Lista de IPs permitidos Até 50 endereços IPv4 ou IPv6 ou faixas CIDR; requisições de outros endereços são recusadas
Limite diário de gasto O máximo que essa chave pode gastar (líquido) por dia UTC; acima disso, as compras são recusadas e nada é cobrado
Expiração Uma data opcional depois da qual a chave para de funcionar, no máximo 2 anos à frente

Use uma chave por aplicação ou servidor, com os menores escopos necessários. Uma conta pode ter até 10 chaves ativas.

Confirmar mudanças sensíveis

Criar uma chave, rotacioná-la, adicionar um webhook, trocar o segredo de um webhook e afrouxar uma chave (mais escopos, uma lista de IPs maior, um limite mais alto ou uma expiração mais tardia) pedem sua senha de novo, além do código da verificação em duas etapas se ela estiver ativada. A confirmação vale por 5 minutos. Revogar uma chave e apertar seus limites nunca pedem isso.

Rotação sem interrupção

Rotacionar dá um novo segredo à chave, mantendo as configurações, o uso e os webhooks. Você escolhe um período de transição de até 72 horas em que o segredo antigo ainda funciona, para atualizar seus servidores sem interrupção.

Revogar

Revogar para a chave na hora e de vez. Os webhooks dela também são desativados.

Se uma chave vazou

  1. Revogue a chave, ou rotacione com um período de transição de 0 hora.
  2. Confira o registro de requisições da chave (últimos 7 dias) e sua Carteira em busca de atividades que você não reconhece.
  3. Crie uma nova chave com lista de IPs permitidos e limite diário de gasto.

O que registramos

As chaves nunca aparecem em nenhum log. Para cada requisição guardamos por 7 dias o horário, a rota, o status, a duração e um id da requisição, e você pode vê-los por chave. Criar, rotacionar e revogar chaves também aparece na atividade da conta, e cada chave nova gera uma notificação.

Nunca pelo navegador

A API não aceita chamadas feitas por páginas web (não há CORS). Chame-a apenas a partir dos seus próprios servidores.

Este artigo foi útil?

Ainda precisa de ajuda?

Escreva para nós. Respondemos a todas as mensagens, geralmente em poucas horas.

Ou envie um e-mail para support@smsgrab.com