Developer guide

controllo stato spedizioni sms in post http

Grazie alle A.P.I. (Application Programming Interface)
di smSend puoi oggi integrare tutte le funzioni del nostro
software all'interno della tua applicazione, software o sito web.

 

Controllo stato spedizioni SMS in Post HTTP

POST URL: http://app.smsend.it/sms/batch-status.php
 
Parametri autenticazione:
user - Login cliente o rivenditore (visibile all'interno del proprio account "rivenditore")
pass - Password cliente o rivenditore
 
Parametri obbligatori:
id - Identificativo della spedizione (request_id specificato al momento dell'invio della richiesta)
type - Tipo di report desiderato ("queue" stato accodamento messaggi, "notify" stato delle notifiche dei messaggi inviati, "mnc" stato delle richieste MNC)
schema - Schema del report ("1" è l'unico schema attualmente supportato).
 
Il server risponderà con i dati del report richiesto in formato CSV con i campi separati da virgola, dove la prima riga conterrà i nomi delle colonne.
 
In caso di errore la risposta del server sarà "KO <testo_errore>".
 
Codici errore:

KO Accesso non consentito (utente non abilitato).
KO Accesso non consentito (IP non abilitato).
KO Parametro <nome_parametro> non impostato.
KO Parametro <nome_parametro> non corretto.
KO Accesso non consentito.
KO Parametri non corretti.
KO Errore interno.
Esempio:
http://app.smsend.it/sms/batch-status.php?user=demo_user&pass=user_demo&id=123&type=queue&schema=1
N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio back-office.
N.B. Devi avere un account smSend.

 

Esempio di report CSV con parametro "type=queue":
id,dest,status,status_text
9182,+393209999999,100,Queued
9183,+393339999999,200,Sent
9184,+393409999999,302,Temporary failure
Esempio di report CSV con parametro "type=notify":
id,dest,status,status_text
9184,+393209999999,100,Waiting
9185,+393339999999,200,Delivered
9186,+393409999999,300,Unknown subscriber
Esempio di report CSV con parametro "type=mnc":
id,dest,status,netcode,status_text
9186,+393209999999,100,Waiting
9187,+393339999999,200, TIM
9188,+393409999999,300,Unknown subscriber


Github - Social codingRepository delle A.P.I. smSend su Github

Contribuisci e crea anche tu progetti unici con il repository delle A.P.I. smSend su Github - social coding - http://github/smsend