Começar depressa

Do zero ao primeiro SMS em menos de cinco minutos.

1. Obter a chave

  • Entra na tua conta DroidSender
  • Abre a página API
  • Carrega em Nova chave
  • Dá-lhe um nome e copia-a (formato DS-live-xxxx)

2. Confirmar que há um dispositivo online

bash
curl -X GET https://api.droidsender.com/api/v1/devices \
  -H "X-API-Key: DS-live-a-tua-chave"

3. Enviar o primeiro SMS

bash
curl -X POST https://api.droidsender.com/api/v1/sms/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: DS-live-a-tua-chave" \
  -d '{
    "to": "+351912345678",
    "message": "Confirmamos a sua consulta de dia 10/08 as 11h15.",
    "deviceId": "dev_oppo_cph2577"
  }'

O mesmo em Python

python
import requests

r = requests.post(
    "https://api.droidsender.com/api/v1/sms/send",
    headers={"X-API-Key": "DS-live-a-tua-chave"},
    json={
        "to": "+351912345678",
        "message": "Confirmamos a sua consulta de dia 10/08 as 11h15.",
        "deviceId": "dev_oppo_cph2577",
    },
    timeout=10,
)
print(r.json())

O mesmo em JavaScript

javascript
const r = await fetch("https://api.droidsender.com/api/v1/sms/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "DS-live-a-tua-chave",
  },
  body: JSON.stringify({
    to: "+351912345678",
    message: "Confirmamos a sua consulta de dia 10/08 as 11h15.",
    deviceId: "dev_oppo_cph2577",
  }),
});
console.log(await r.json());

Enviado não é entregue

A resposta confirma que a mensagem saiu para a rede. A confirmação de entrega chega depois, pelo webhook sms.delivered.