Autenticación con claves API

Cada endpoint, excepto los dos endpoints de precios, necesita una clave API en el encabezado Authorization.

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

Creando claves

• Las claves se crean en la página de claves API de la consola. La página se abre después de que se añade la primera recarga al saldo.
• Una cuenta puede tener 10 claves activas. Asigna a cada aplicación o entorno su propia clave y nombre, para que una pueda ser reemplazada sin afectar a las demás.
• Una clave es bsa_live_ seguido de 32 letras y dígitos. Se muestra una vez, cuando se crea; solo guardamos un hash cifrado, por lo que una clave perdida no se puede mostrar nuevamente. Crea una nueva en su lugar.
• La lista muestra los primeros caracteres, los últimos cuatro, cuándo se creó la clave y cuándo se usó por última vez.

Rotando y revocando

Para rotar una clave sin tiempo de inactividad: crea una segunda clave, despliégala, verifica su último tiempo de uso en la consola, luego revoca la clave antigua. Una clave revocada responde 401 unauthorized desde la siguiente solicitud.

Manteniendo las claves seguras

• Llama a la API desde tu servidor, nunca desde un navegador o una aplicación móvil: cualquiera con la clave puede enviar mensajes desde tu saldo.
• Mantén las claves en variables de entorno o un gestor de secretos, no en el control de código fuente.
• Cada clave tiene su propio contador de límite de tasa, por lo que un trabajador ocupado no ralentiza una segunda clave usada en otro lugar.

Errores

{
  "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"
  }
}