API para envio de SMS

Use este endpoint para integrar sistemas, sites, lojas, CRMs ou automacoes com o envio de SMS da LS BAHAMAS. Cada cliente deve receber uma API Key com saldo disponivel.

Ver exemplo pronto Abrir site

Endpoint

GET https://bahamas.net.br/api/v1/sendsms_v1

api_key

Chave do cliente gerada no painel.

telefone

Numero do destinatario com DDD. Exemplo: 11933356879.

mensagem

Texto do SMS. Use URL encode quando houver espacos ou acentos.

O envio desconta saldo da API Key somente quando a API principal retornar sucesso. Cada unidade custa R$0,15. Se uma mensagem consumir 2 unidades, o sistema desconta 2 x R$0,15.

Respostas

Sucesso

{"erro":false,"message":"Mensagem enviada com sucesso."}

Erro

{"erro":true,"message":"Acesso negado. API Key invalida ou desativada."}

Sem saldo

{"erro":true,"message":"Saldo insuficiente."}

Cobranca

Retorna unidades, valor_debitado e novo_saldo quando o envio for aceito.

Exemplo de URL

https://bahamas.net.br/api/v1/sendsms_v1?api_key=SUA_API_KEY&telefone=11933356879&mensagem=Teste%20de%20SMS

Exemplo cURL

curl "https://bahamas.net.br/api/v1/sendsms_v1?api_key=SUA_API_KEY&telefone=11933356879&mensagem=Teste%20de%20SMS"

Exemplo JavaScript

const apiKey = 'SUA_API_KEY';
const telefone = '11933356879';
const mensagem = encodeURIComponent('Teste de SMS');
const url = 'https://bahamas.net.br/api/v1/sendsms_v1?api_key=' + apiKey + '&telefone=' + telefone + '&mensagem=' + mensagem;
fetch(url).then(res => res.json()).then(console.log);

Exemplo PHP

$apiKey = 'SUA_API_KEY';
$telefone = '11933356879';
$mensagem = urlencode('Teste de SMS');
$url = "https://bahamas.net.br/api/v1/sendsms_v1?api_key={$apiKey}&telefone={$telefone}&mensagem={$mensagem}";
$resposta = file_get_contents($url);
$dados = json_decode($resposta, true);
print_r($dados);

Para enviar ao cliente, envie este link: https://bahamas.net.br/api/example

Consultar status do envio

Quando o envio for aceito, a resposta pode trazer IDs da API principal em provider_ids. Use esses IDs para consultar entrega depois.

GET https://bahamas.net.br/api/v1/getreport

api_key

Chave do cliente gerada no painel.

ids

IDs retornados no envio, separados por virgula. Exemplo: 123,124.

https://bahamas.net.br/api/v1/getreport?api_key=SUA_API_KEY&ids=123,124