HTTP SMS SERVER – CREDITO RESIDUO #
E’ possibile conoscere il proprio il credito residuo per l’invio di SMS tramite una chiamata HTTP Rest API così strutturata:
- URL: https://secure.agiletelecom.com/services/sms/credit
- METODO: GET
- AUTENTICAZIONE: Basic / Api-Key / OAuth1.1
La risposta sarà in formato JSON (con specifica Jsend in caso di errori):
- 2XX (messaggio accettato dal server)
{
"credit": 10.324
}| CAMPO | TIPO | NOTE |
|---|---|---|
| credit | double | Credito residuo dell’account espresso in € |
- 5XX (richiesta non processata per errori lato server)
{
"status": "error",
"message": "Number check service unavailable",
"code": 9
}| CAMPO | TIPO | NOTE |
|---|---|---|
| status | string | Vale sempre “error” per gli errori 5XX |
| message | string | Descrive il tipo di problema riscontrato lato server durante l’elaborazione della richiesta |
| code | integer | Codice di errore custom. Indica la tipologia di problema secondo quanto specificato nella tabella dei codici di errore riportata successivamente |
| CODICE | DESCRIZIONE |
|---|---|
| 1 | Credenziali errate |
| 2 | Credito insufficiente |
| 4 | Numero/i di destinazione errato/i, formato non valido. |
| 6 | Manca almeno un corpo del messaggio |
| 7 | Almeno il corpo del messaggio è troppo lungo o alcuni caratteri non sono supportati. |
| 8 | Errore del server |
| 9 | Errore del server (timeout) |
| 10 | Manca almeno un mittente |
| 11 | Utente non trovato (credenziali errate) |
| 13 | Manca almeno un numero di destinazione |
| 14 | Mancano gli elementi del messaggio |
| 15 | Gli array Destinations e Ids hanno lunghezze diverse |
| 18 | Mittente sbagliato o mittente non consentito |
| 20 | Valore di globalId non consentito |
| 21 | Valore di maxIdLen non consentito |
| 22 | Il valore di udgData non è corretto |
| 23 | Il valore della programmazione non è corretto |
| 24 | Il valore del corpo non è consentito |
| 100 | L’IP di origine non è consentito |
