EnglishSpedisci il tuo primo messaggio in un pomeriggio
Una semplice API REST per l'invio, il monitoraggio e la ricezione di SMS: autenticazione del token, webhook in tempo reale e SDK, senza nulla di esotico da imparare.
Tre mosse, inizio consegna
Ogni integrazione è lo stesso breve arco: autenticazione, invio e tracciamento.
Invia la tua chiave di accesso come intestazione token, con Content-Type: application/json, su ogni richiesta.
PUBBLICARE un mittente, un destinatario e un contenuto. La risposta ritorna immediatamente con un msgid e un codice di errore.
PUBBLICHIAMO o RICEVIAMO un rapporto sullo stato sul tuo URL di richiamata nel momento in cui un messaggio raggiunge il suo 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 }'msgstr "9f2a7c10-4b2e-…"
direzione "mt"
codiceerrore 0
Salva il msgstr - è così che segui questo messaggio da qui.
Leggi un messaggio dall'alto verso il basso
Gli eventi di invio, stato e in entrata restituiscono tutti la stessa forma: imparalo una volta.
ID del messaggio
msgid: coniato nel momento in cui viene creato un messaggio. Questo è l'handle che usi per controllarne lo stato in seguito.
Mittente
da: un numero di telefono o un ID alfanumerico fino a 11 caratteri, a seconda dell'identità visualizzata dai destinatari.
Destinatario
a: il numero a cui è diretto il messaggio, compreso il prefisso internazionale.
Codifica
codifica dati: GSM7 contiene 160 caratteri per parte; passa a Unicode e scende a 70. Vai oltre e si concatena in parti fatturate extra.
Direzione
direzione: ogni messaggio è mt (lo hai inviato) o mo (lo hai ricevuto), la stessa forma in entrambi i casi.
Codice errore
codice errore: restituito nella risposta di invio e in ogni rapporto sullo stato. 0 significa accettato; qualsiasi altra cosa ti dice esattamente cosa è andato storto.
Un punto finale, due verbi
POST per inviare, GET per controllare lo stato: lo stesso URL e la stessa intestazione token in ogni caso.
Inviare
Invia un messaggio e ricevi immediatamente un msgid e un codice di errore.
Ritorni msgid + codice erroreTraccia
Cerca un messaggio che hai già inviato per verificarne lo stato corrente.
Ritorni messaggio + statoRapporti sullo stato, nel momento in cui si verificano
Imposta un URL di richiamata e ogni consegna, errore e risposta in entrata arriva lì come GET o POST, senza bisogno di polling.
Ottieni la tua chiave API
Inizia l'integrazione in pochi minuti con la nostra API REST.
Documenti per sviluppatori: domande frequenti
Passa la tua chiave di accesso in un'intestazione Token su ogni richiesta — Token: {accessKey} — insieme a Content-Type: application/json.
Ogni invio restituisce un msgid. Indicaci un URL di richiamata e POSTIAMO o OTTIENI un rapporto sullo stato nel momento in cui il messaggio raggiunge il suo stato finale: subdate, donedate e il codice di stato risultante inclusi.
mt (mobile terminato) è un messaggio che hai inviato; mo (origine mobile) è una risposta che hai ricevuto. Entrambi utilizzano la stessa forma dell'oggetto messaggio.
La consegna viene ritentata in base alla policy dei tentativi: nulla viene eliminato silenziosamente, ma un endpoint che non riconosce mai continuerà a ricevere tentativi.
160 caratteri su codifica GSM7 o 70 su Unicode. Supera il limite e il messaggio si concatena in più parti, ciascuna fatturata separatamente.