Cloud DNS
API endpoint SOAP
Meccanismo di autenticazione
Le API sono protette con account e password e richiedono un'autorizzazione per ogni operazione, per maggiori dettagli consulta gli articoli relativi a come ottenere le
credenziali di accesso ed
effettuare la prima connessione. Una volta ottenute le credenziali per l'autenticazione (username e password) sarà necessario invocare il metodo GetUserAuthenticationToken, il quale, a fronte della presentazione di credenziali corrette, genera un token (temporaneo e temporale) che mantiene lo stato di autenticazione per l'utente. Non vi sarà quindi necessità di ri-autenticarsi.
Di seguito un esempio C# di utilizzo di tale metodo:
private static void LoginToWsEndUser(WsEndUserClient client)
{
//specifica le credenziali dell'account
client.ClientCredentials.UserName.UserName = "ARU-0000";
client.ClientCredentials.UserName.Password = "0123456789";
try
{
var result = client.GetUserAuthenticationToken();
if (result.Success)
{
//il metodo è andato a buon fine
}
else
{
throw new Exception(result.ResultMessage);
}
}
catch (MessageSecurityException msEx)
{
//utente non autenticato
throw new Exception(msEx.Message);
}
catch (Exception ex)
{
//eccezione generica
throw new Exception(ex.Message);
}
}
Per maggiori informazioni:
https://kb.cloud.it/api/api/login-ed-uso-del-token-sostitutivo.aspx
URL web documentazione API
Funzionalità invocabili tramite API
- Ottenere la lista dei servizi Dns acquistati dall'utente autenticato (GetPurchasedDNS)
- Ottenere la lista dei TLD disponibili (GetDnsTLDs)
- Acquistare una zona Dns dall'utente autenticato (SetPurchaseDNS)
- Rimuovere una zona Dns posseduta dall'utente autenticato (SetRemoveDNS)
- Ripristinare una zona Dns precedentemente disabilitata (SetEnableDNS)
- Disabilitare una zona Dns (SetDisableDNS)
- Ottenere la lista dei DnsRecords di una zona Dns specifica (GetDNSRecords)
- Impostare una lista dei DnsRecords di una zona Dns specifica (SetDnsRecords)
- Controllare la disponibilita di una zona Dns (CheckIsAvailableDns)
- Ottenere la lista dei Dns posseduta dall'utente autenticato (GetAllDNS)
- Ottenere il costo totale dei servizi Dns acquistati dall'utente autenticato (GetAllDnsCost)
- Ottenere il listino prezzi dei prodotti correlati al servizio Dns (GetDnsPricelist)
- Torna lista dei job relativi al servizio Dns in attesa o in esecuzione (GetJobs)
- Torna lista dei job relativi al servizio Dns completati con successo o fallimento (GetLogs)