Istruzioni dell' interfaccia
Generale
La nostra interfaccia HTTP supporta l'invio di SMS di testo. Questo documento è destinato agli sviluppatori che vogliono integrare l'invio di SMS come funzione nelle loro applicazioni (ad esempio estensioni di server web, messaggistica unificata, servizi informativi, ecc.)
Come funziona
I dati vengono trasmessi con l'aiuto di richieste HTTP-GET o HTTP-POST, il server si aspetta HTTP sulla porta 80. Le richieste devono essere inviate all'URL https://smshub.it/sms_http.
Parametri
| Variabile | Obbligatorio | Sintassi | Descrizione |
|---|---|---|---|
| user | sì | max@mustermann.com | Indirizzo mail del suo account |
| pw | sì | *********** | Password del suo account |
| snr | no | smshub.it | Mittente - 11 caratteri di testo o numero a 16 cifre. Per poter utilizzare il proprio mittente, è necessario registrarlo( a pagamento). |
| dnr | sì | 39123456789 | Destinatario - con codice paese senza + |
| msg | sì | Hello world | Messaggio di testo fino a 160 caratteri. Il messaggio deve essere URL codificato. |
| deliv | no | 60 | Ritardo in minuti con cui viene inviato l'SMS. |
| ip | no | 192.0.0.1 | È possibile indicare qui l'indirizzo IP del client che deve essere bloccato. |
| time | no | 3600 | Durata del blocco di reinvio in secondi. Nessun altro SMS può essere inviato dall'ip inviato per i secondi specificati. Il valore predefinito è 86400 secondi. |
| max | no | 3 | Numero di SMS massimo per un rispettivo indirizzo IP nel tempo specificato. Il valore predefinito è 3. |
Esempio
Invio di un SMS normale
https://smshub.it/sms_http.php?user=username&pw=*******&snr=smshub.it&dnr=39123456789&msg=Hello+World
Notifiche del sistema
Viene emesso il seguente feedback
| Output | Spiegazione |
|---|---|
| +1 # SMS done | SMS accettato con successo |
| -1 # Missing parameter (xxx) | Richiesta HTTP non corretta. Mancano i parametri "xxx" |
| -2 # Unknown username (xxx) | L'indirizzo mail "xxx" non è corrretto. |
| -3 # Password (xxx) is wrong | La password "xxx" non è corretta. |
| -4 # Account empty | Il tuo credito è esaurito. Devi acquistare nuovi crediti per poter eseguire altri ordini. |
| -5 # Error | Errore di sintassi o errore sconosciuto. Per esempio, la sintassi del ricevitore (dnr) potrebbe non essere corretta. |
| -6 # IP locked - still xxx | L'indirizzo IP inviato è ancora bloccato per xxx. |
| -7 # IP locked - allready send xxx SMS today | L'indirizzo IP inviato è bloccato perché ha superato il numero massimo giornaliero di SMS. |
In caso di problemi o ulteriori domande, contattare info@piloly.com.