REST API

Una REST API (Representational State Transfer Application Programming Interface) è un'interfaccia standardizzata per la comunicazione tra sistemi software tramite HTTP. Consente l'accesso programmatico a servizi come le piattaforme di messaggistica – in modo strutturato, scalabile e indipendente dalla piattaforma.

Che cos'è una REST API?

Una REST API è un'interfaccia di programmazione che consente alle applicazioni di comunicare tra loro tramite richieste HTTP standardizzate. REST sta per "Representational State Transfer": uno stile architetturale costruito su tecnologie web esistenti, ovvero metodi HTTP (GET, POST, PUT, DELETE), URL come indirizzi delle risorse e JSON o XML come formati di dati.

Nel contesto della messaggistica significa: il tuo software invia una richiesta POST a un URL come https://api.sendseven.com/v1/messages con dati JSON (destinatario, testo del messaggio, canale), l'API elabora la richiesta e restituisce una risposta (ad esempio "Messaggio inviato, ID: 12345").

Le REST API sono stateless: ogni richiesta contiene tutte le informazioni necessarie. L'autenticazione avviene tramite API key, OAuth o Bearer Token. Le risposte utilizzano codici di stato HTTP standard (200 OK, 401 Unauthorized, 500 Server Error) per una gestione coerente degli errori.

Perché le REST API sono importanti per la messaggistica?

Le REST API rendono le piattaforme di messaggistica utilizzabili in modo programmatico: nessun intervento manuale, piena automazione:

  • Integrazione di sistemi – CRM, ERP e piattaforme e-commerce inviano messaggi automaticamente
  • Automazione – Conferme d'ordine, notifiche di spedizione, promemoria di appuntamenti
  • Scalabilità – Elaborazione di migliaia di messaggi in parallelo
  • Indipendenza dalla piattaforma – Qualsiasi linguaggio di programmazione (Python, Node.js, PHP, Java) può inviare richieste HTTP
  • Tecnologia standard – Gli sviluppatori conoscono REST, nessun protocollo proprietario da imparare

A differenza delle interfacce grafiche, le REST API consentono una comunicazione basata sugli eventi: "Quando arriva un ordine, invia una conferma WhatsApp". Questo abilita flussi di lavoro in tempo reale senza alcun intervento manuale.

Esempio pratico

Un negozio online vuole inviare una conferma WhatsApp dopo ogni ordine. Il negozio utilizza la REST API di SendSeven:

POST https://api.sendseven.com/v1/messages

Corpo della richiesta (JSON):

{
  "to": "+393331234567",
  "channel": "whatsapp",
  "text": "Grazie per il tuo ordine #12345! Spediremo il pacco domani."
}

L'API autentica la richiesta tramite l'API key nell'header, valida i dati, instrada il messaggio alla Cloud API di WhatsApp e restituisce una risposta:

{
  "messageId": "msg_abc123",
  "status": "sent",
  "timestamp": "2026-02-19T14:32:00Z"
}

Il negozio memorizza il message ID per tracciare in seguito lo stato di consegna tramite webhook. Tutto automatico, senza alcun intervento manuale.

REST API di SendSeven

La REST API di SendSeven è completamente documentata, pensata per gli sviluppatori e moderna: specifica OpenAPI (Swagger), documentazione interattiva con funzione "try it out" ed esempi di codice in tutti i linguaggi più diffusi.

Endpoint unificato: /v1/messages funziona per WhatsApp, Telegram, Email, SMS, Messenger, Instagram e Live Chat – un unico formato di richiesta per tutti i canali. Supporto webhook per eventi in tempo reale (message.received, message.delivered, message.read); consulta la voce di glossario Webhook per l'elenco completo.

Autenticazione tramite API key (semplice) o OAuth 2.0 (enterprise). Rate limiting documentato in modo trasparente. Conforme al GDPR, hosting nell'UE. Documentazione API completa: docs.sendseven.com