OlyBulk | API

API

Integração simples para envio de SMS por API

Saldo disponível Ativo

0.00 MZN

SMS estimados: 0

Preço estimado por SMS: 3.25 MZN

API Key

Chave atual

A carregar...

Criada em: —

Informação base

Base URL

https://api-sms-service-815241442321.us-central1.run.app

Autenticação

Header x-api-key

Formato

JSON

Endpoint principal

POST /v1/sms/send

Envia uma mensagem SMS para um ou vários destinatários usando a tua API key.

Headers

x-api-key: SUA_API_KEY
Content-Type: application/json

Body

{
  "to": ["258841234567", "258861234567"],
  "message": "O seu código é 1234"
}

Resposta de sucesso

{
  "ok": true,
  "message": "SMS queued successfully",
  "data": {
    "totalRecipients": 2,
    "segments": 1,
    "totalCost": 5,
    "status": "queued"
  }
}

Exemplo em cURL

curl -X POST "https://api-sms-service-815241442321.us-central1.run.app/v1/sms/send" \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_API_KEY" \
  -d '{
    "to": ["258841234567", "258861234567"],
    "message": "Promoção válida hoje"
  }'

Exemplo em JavaScript

fetch("https://api-sms-service-815241442321.us-central1.run.app/v1/sms/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "SUA_API_KEY"
  },
  body: JSON.stringify({
    to: ["258841234567"],
    message: "Olá! Este é um teste."
  })
})
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Exemplo em PHP

$payload = [
    "to" => ["258841234567"],
    "message" => "Olá! Este é um teste."
];

$ch = curl_init("https://api-sms-service-815241442321.us-central1.run.app/v1/sms/send");

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "x-api-key: SUA_API_KEY"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Consultar saldo

GET /v1/sms/balance

Consulta o saldo disponível da conta associada à API key.

Headers

x-api-key: SUA_API_KEY

Resposta de sucesso

{
  "ok": true,
  "data": {
    "balance": 1250,
    "currency": "MZN",
    "estimatedSmsUnitPrice": 2.5,
    "estimatedSmsAvailable": 500,
    "account": {
      "id": "user_id",
      "name": "Nome",
      "email": "email@email.com"
    }
  }
}

Exemplo em cURL

curl -X GET "https://api-sms-service-815241442321.us-central1.run.app/v1/sms/balance" \
  -H "x-api-key: SUA_API_KEY"

Exemplo em JavaScript

fetch("https://api-sms-service-815241442321.us-central1.run.app/v1/sms/balance", {
  method: "GET",
  headers: {
    "x-api-key": "SUA_API_KEY"
  }
})
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Exemplo em PHP

$ch = curl_init("https://api-sms-service-815241442321.us-central1.run.app/v1/sms/balance");

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: SUA_API_KEY"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Testar endpoint de saldo

API Key

Resposta

{ }

Notas

Os números devem ir no formato normalizado, por exemplo: 258841234567
O custo depende do número de destinatários e da quantidade de partes SMS.
Se o saldo for insuficiente, a API devolve erro.
A API key deve ser mantida em segredo.
Máximo 100 requests por minuto