API REST
Invia SMS dalle tue applicazioni
Endpoint semplici, autenticazione Bearer, risposte JSON e idempotenza per evitare duplicati.
Autenticazione
Crea una chiave nell'area riservata e inviala nell'header Authorization. La chiave completa viene mostrata una sola volta.
Authorization: Bearer psms_...Invio SMS
POST /api/v1/sms/send accetta JSON. Usa sempre un valore univoco in Idempotency-Key quando ritenti una richiesta.
{
"name": "Promemoria appuntamento",
"sender_id": 0,
"recipients": ["393331234567"],
"message": "Appuntamento domani alle 10:30",
"landing_page_id": 0
}sender_id: 0 usa il cellulare verificato dell'account; per un Alias aziendale approvato usa il suo ID. La risposta riporta destinatari, SMS consumati e identificativo della campagna. Un testo oltre il limite del singolo SMS viene segmentato automaticamente.
Leggi il saldo
GET /api/v1/sms/balance restituisce il numero di SMS disponibili.
{"success":true,"data":{"sms_balance":4820}}Codici principali
202Invio acquisito401Chiave non valida402SMS insufficienti422Dati non validi o mittente numerico non verificato429Limite richieste superato