API HostingSolutions (HSAPI)

Le HSAPI sono rivolte ai rivenditori che desiderano costruire degli automatismi propri per poter ordinare dei servizi. Lo scenario tipico è il rivenditore che all'interno del proprio sito raccoglie ordini dai propri clienti e li gira al pannello di controllo di Hosting Solutions. Le HSAPI utilizzano un sistema di comunicazione basato su messaggi XML su protocollo HTTPS.

La sicurezza del sistema è basata su più meccanismi: la comunicazione avviene su protocollo criptato HTTPS, ogni comunicazione richiede le credenziali di autenticazione, la sessione è rigidamente controllata da una sequenza random di identificativi, ogni rivenditore è vincolato all'utilizzo di un set di IP che deve comunicare.

Attraverso le HSAPI il rivenditore attualmente potrà ordinare solo i servizi di registrazione dominio, e cambio registrante, ma progressivamente questa tecnologia renderà possibile ordinare l'intero set di servizi di Hosting Solutions.

Il sistema prevede che il rivenditore acquisti un credito prepagato PrePay, che verrà scalato degli importi
relativi agli ordini che via via effettua. Lo stato del credito può essere controllato sia tramite la
funzionalità apposita del pannello di controllo, sia tramite i messaggi HSAPI. Il credito può essere
ricaricato in qualunque momento dal nostro pannello di controllo. Nel caso un ordine non sia
effettuabile (es. registrazione di un dominio che fallisce per dati non validi) il credito che inizialmente viene scalato verrà ripristinato automaticamente.

Comunicazione tramite API

La comunicazione avviene tramite uno scambio di messaggi XML, su protocollo HTTPS. La sessione di comunicazione è mantenuta tramite la variabile APISESSION presente nell' header HTTP delle richieste e delle risposte.

Ogni comando inviato al deve contenere un valore valido di APISESSION. L'unico comando che non necessita di una sessione correntemente valida, è il comando Login.

A seguito di un comando il server invia sempre una risposta in cui indica un nuovo valore di APISESSION che dovrà essere specificato nella successiva richiesta.

Per l'abilitazione della comunicazione attraverso API, il rivenditore ci dovrà comunicare gli IP da cui intende utilizzare le HSAPI, e saranno validate le sole richieste provenienti da tali IP. Dopo l'attivazione, vi forniremo la completa documentazione sui comandi da utilizzare nel vostro sito.