ITA – SMS Credit Check

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