EnglishInvia il tuo primo messaggio in un pomeriggio
Una semplice API REST per l'invio, il monitoraggio e la ricezione di SMS — autenticazione token, webhook e SDK in tempo reale, senza nulla di esotico da imparare.
Tre mosse, iniziare a consegnare
Ogni integrazione è lo stesso arco breve: autenticare, inviare, quindi tracciare.
Invia la tua chiave di accesso come intestazione Token, con Content-Type: application/json, ad ogni richiesta.
PUBBLICA un contenuto da, a e. La risposta viene immediatamente restituita con un msgid e un codice di errore.
PUBBLICHIAMO o RICEVIAMO un rapporto sullo stato del tuo URL di richiamata nel momento in cui un messaggio raggiunge lo stato finale.
Una richiesta, nella lingua che già usi
PUBBLICA il mittente, il destinatario e il contenuto con un'intestazione Token. La risposta ritorna nel momento in cui la accettiamo.
01curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \02 -H "Token: $SMSLOCAL_TOKEN" \03 -H "Content-Type: application/json" \04 -d '{05 "from": "SMSLOCAL",06 "to": "14155550123",07 "content": "Your code is 481920."08 }'msgid "9f2a7c10-4b2e-..."
direzione MT:
CODICE ERRORE 0
«Risparmia la..." msgid — è il modo in cui si tiene traccia di questo messaggio da qui.
Leggi un messaggio dall'alto verso il basso
Invio, stato ed eventi in entrata restituiscono tutti la stessa forma: imparalo una volta.
Identificativo del messaggio
msgid — coniato nel momento in cui viene creato un messaggio. Questa è la maniglia che usi per controllarne lo stato in seguito.
Mittente
from — un numero di telefono o un ID alfanumerico fino a 11 caratteri, indipendentemente dall'identità visualizzata dai destinatari.
Destinatario
a — il numero a cui verrà inviato il messaggio, incluso il prefisso internazionale.
Codifica
codifica dati — GSM7 si adatta a 160 caratteri per parte; passa a Unicode e scende a 70. Passa oltre e si concatena in parti fatturate extra.
Direzione
direzione — ogni messaggio è mt (l'hai inviato) o mo (l'hai ricevuto), la stessa forma in entrambi i casi.
Codice errore
errorcode — restituito sulla risposta di invio e su ogni rapporto di stato. 0 significa accettato; qualsiasi altra cosa ti dice esattamente cosa è andato storto.
Un endpoint, due verbi
PUBBLICA per inviare, controlla lo stato: lo stesso URL e la stessa intestazione del token in entrambi i casi.
Invia
Invia un messaggio e ricevi immediatamente un msgid e un codice di errore.
Resi msgid + codice erroreTraccia
Cerca un messaggio che hai già inviato per verificarne lo stato attuale.
Resi Stato messaggioRapporti sullo stato, nel momento in cui si verificano
Imposta un URL di richiamata e ogni consegna, errore e risposta in entrata atterrerà lì come GET o POST — non è richiesto alcun polling.
<a href="%s" target="_blank"> Prendi la tua chiave API </a>
Inizia a integrarti in pochi minuti con la nostra API REST.
Documenti dello sviluppatore — domande frequenti
Passa la tua chiave di accesso in un'intestazione Token a ogni richiesta — Token: {accessKey} — insieme a Content-Type: application/json.
Ogni invio restituisce un msgid. Indicaci un URL di richiamata e PUBBLICHIAMO o RICEVIAMO un rapporto sullo stato nel momento in cui il messaggio raggiunge il suo stato finale: subdata, donedate e il codice di stato risultante incluso.
mt (cellulare terminato) è un messaggio che hai inviato; mo (cellulare originato) è una risposta che hai ricevuto. Entrambi utilizzano la stessa forma di oggetto messaggio.
La consegna viene ritentata in base alla politica dei tentativi: nulla viene lasciato cadere in silenzio, ma un endpoint che non riconosce mai continuerà a ricevere tentativi.
160 caratteri sulla codifica GSM7 o 70 su Unicode. Superato il limite, il messaggio si concatena in più parti, ciascuna fatturata separatamente.