Autenticação com chaves da API

Cada endpoint, exceto os dois endpoints de preços, precisa de uma chave da API no cabeçalho Authorization.

POST /v1/messages HTTP/1.1
Host: bulksmsapi.cc
Authorization: Bearer bsa_live_7QzX2mW9kR4tB8nV1cJ6yP3sH5dL0aFe
Content-Type: application/json

Criando chaves

• As chaves são criadas na página de chaves da API do console. A página abre após a primeira recarga ser adicionada ao saldo.
• Uma conta pode ter 10 chaves ativas. Dê a cada aplicativo ou ambiente sua própria chave e nome, para que uma possa ser substituída sem afetar as outras.
• Uma chave é bsa_live_ seguido por 32 letras e dígitos. Ela é exibida uma vez, quando é criada; mantemos apenas um hash chaveado, então uma chave perdida não pode ser exibida novamente. Crie uma nova em vez disso.
• A lista mostra os primeiros caracteres, os últimos quatro, quando a chave foi criada e quando foi usada pela última vez.

Rotacionando e revogando

Para rotacionar uma chave sem tempo de inatividade: crie uma segunda chave, implante-a, verifique o tempo de último uso no console e então revogue a chave antiga. Uma chave revogada responde 401 unauthorized a partir da próxima solicitação.

Mantendo as chaves seguras

• Chame a API do seu servidor, nunca de um navegador ou aplicativo móvel: qualquer pessoa com a chave pode enviar mensagens do seu saldo.
• Mantenha as chaves em variáveis de ambiente ou um gerenciador de segredos, não no controle de versão.
• Cada chave tem seu próprio contador de limite de taxa, então um worker ocupado não desacelera uma segunda chave usada em outro lugar.

Erros

{
  "error": {
    "code": "unauthorized",
    "message": "Send your API key as Authorization: Bearer bsa_live_... Keys are created in the console under API keys.",
    "doc_url": "https://bulksmsapi.cc/en/docs/errors#unauthorized"
  }
}