INTRODUZIONE

Grazie alle REST API puoi integrare il tuo software con il nostro gateway in modo semplice e rapido.

Le REST API si basano sui metodi HTTP quindi per l'integrazione potrai utilizzare un Client HTTP scritto in un qualsiasi linguaggio di programmazione.

Url base dei servizi

L'indirizzo base da utilizzare per accedere alle REST API è il seguente

https://api.amm.cloud/sms/v2

Per motivi di sicurezza le REST API utilizzano il solo protocollo HTTPS (il protocollo HTTP non è supportato).

EFFETTUARE UNA RICHIESTA

Autenticazione

Tutte le richiesta alle REST API necessitano di essere autenticate attraverso il meccanismo della HTTP Basic authentication.

Lo username e la password da fornire sono i codici AUTH_KEY e AUTH_SECRET associati al tuo profilo.

Visita la sezione gestione sicurezza API nella tua area privata per recuperare tali valori.

Puoi testare le tue credenziali chiamando semplicemente da browser il seguente URL:

https://AUTH_KEY:AUTH_SECRET@api.amm.cloud/sms/v2/user

oppure eseguendo da shell Linux il comando

curl --user AUTH_KEY:AUTH_SECRET https://api.amm.cloud/sms/v2/user

Nel caso l'autenticazione non vada a buon fine viene restituito l'errore HTTP 401.

Econding e Content-Type

Tutte le richieste alle REST API devono esssere encodate in UTF-8.

Le richieste in HTTP POST e HTTP PUT devono settare il valore dell'header Content-Type ad application/x-www-form-urlencoded

Scegliere il formato di risposta

Le REST API possono restituire le infomazioni sia nel formato JSON (default) che XML.

Per ottenere la risposta nel formato desiderato utilizza l'header HTTP "Accept" nella tua richiesta.

- Accept:application/json per ottenere un JSON

curl -H "Accept: application/json" --user AUTH_KEY:AUTH_SECRET https://api.amm.cloud/sms/v2/user

- Accept:application/xml per ottenere un XML

curl -H "Accept: application/xml" --user AUTH_KEY:AUTH_SECRET https://api.amm.cloud/sms/v2/user