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 acquisito
401Chiave non valida
402SMS insufficienti
422Dati non validi o mittente numerico non verificato
429Limite richieste superato
Crea account gratuito