Per ottenere l'URL di base dell'API REST per il tuo account, accedi al tuo account e cercalo all'interno di Settings/Web Services/API Explorer
Avrà l'aspetto di:
https://apiserver/ws/rest/api/version
Quando componi l'URL di una risorsa, inizia sempre con il prefisso https://apiserver/ws/rest/api, aggiungi il tipo di risorsa (ad esempio 'contacts' of 'simplemessages') e poi il percorso dettagliato dell'operazione.
Ad esempio, se vuoi ottenere i dati del contatto con ID 987, il tuo URL sarà di questo tipo:
https://apiserver/ws/rest/api/contacts/contact/987
Autenticazione
Per accedere all'API è necessario autenticarsi, solitamente utilizzando il protocollo OAuth 2.0.
Consulta la documentazione di OAuth per sapere come ottenere un access_token.
Quando hai ottenuto un access_token, puoi utilizzarlo per chiamare questa API.
Usare l'access_token in una querystring
Il modo più semplice è aggiungere un parametro "access_token" alla query string
GET https://apiserver/ws/rest/api/contacts/contact/987?access_token=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Usare l'header Bearer HTTP
Un altro modo semplice è aggiungere un header HTTP Bearer alla tua richiesta:
GET https://apiserver/ws/rest/api/contacts/contact/987 Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Questa è la modalità preferibile, perchè gli header HTTP solitamente non vengono registrati, quindi il tuo access_token non viene mai memorizzato da nessuna parte.