Effettuare una richiesta | SmsHosting.it
icon_qa
INTRODUZIONE API REST

Usi l'app Postman?
 

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 su SmsHosting.it.

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.smshosting.it/rest/api/user

oppure eseguendo da shell Linux il comando

curl --user AUTH_KEY:AUTH_SECRET https://api.smshosting.it/rest/api/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 di SmsHosting.it 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.smshosting.it/rest/api/user

- Accept:application/xml per ottenere un XML

curl -H "Accept: application/xml" --user AUTH_KEY:AUTH_SECRET https://api.smshosting.it/rest/api/user

Continua la lettura con la sezione Gestire la risposta