A proposito
Tecnico
Operazioni

SOAPI OVH


Scopri gli API OVH basati su SOAP e WSDL. Clicca qui.



Che cos'è?

Il Servizio di PRE-PAGAMENTO è un mezzo per utilizzare i punti accumulati o acquistati sul tuo conto fedeltà o rivenditore.
Il sistema si basa sul classico sistema di ordini e su quello creato specialmente per l'automazione degli ordini stessi.
100 punti sul tuo conto fedeltà equivalgono ad 1,00€ IVA esclusa.



Tariffe

Un punto sul tuo conto equivale ad un centesimo di euro IVA esclusa.
Per acquistare punti, dovrai ovviamente corrispondere l'IVA dovuta se ne sei soggetto.




Usare i punti:

Potrai regolare i tuoi buoni d'ordine con questo sistema speciale, oppure utilizzare il sistema di classico.
Grazie alla regola "100 punti = 1 euro IVA esclusa", potete esattamente sapere quanti punti sono necessari per convalidare il Vostro ordine.

Ad esempio: ho un buono d'ordine per un server dedicato di 136,15 + IVA (€166,10 IVA incl.) . Posso convalidarlo con 13.615 punti partendo dal mio account.



Rivenditori:

Le pack commercial web propose les noms de domaine à des tarifs ultra préférentiels, au plus près de ceux pratiqués par les Registres comme l’Afnic, Verisign, Nominet, DNSbe, ou encore Eurid.

Automatismi con batch-mail


Questo sistema permette di convertire i punti in ordini ed effettuare operazioni sui tuoi servizi

La procedura di conversione avviene tramite l'invio di una email preformattata all'indirizzo batch@ovh.com, o tramite l'utilizzo di SoAPI. Questa mail dovrà soddisfare una sintassi definita di seguito ed essere autenticata tramite uno dei seguenti metodi: password, firma MD5, PGP o SMIME.

Sinottica da seguire:
  • 1. Crea il tuo ordine/operazione e segui la sintassi indicata
  • 2. Autentica il tuo ordine tramite uno dei seguenti metodi: password, firma MD5, PGP o SMIME.
  • 3. Invia il tuo ordine/operazione tramite email a batch@ovh.com
    (utilizza batch-test@ovh.com se desideri effettuare un test)

Per creare la tua email, ecco le regole da rispettare:
  • Il sistema di prepagamento è in grado di interpretare solo email con corretta formattazione inviate come testo semplice su batch@ovh.com
  • Se utilizzi l'autenticazione MD5, la firma dovrà essere aggiunta alla fine dell'email in testo semplice.
  • Non allegate file.

Potrai anche utilizzare l'indirizzo batch-test@ovh.com che ti permetterà di simulare l'ordine/operazione per familiarizzare con questo sistema di email.

Potrai anche utilizzare un assistente generatore di batch-mail, a tua disposizione nel Spazio Cliente OVH, sezione Amministrazione > Spazio fedeltà/rivenditore > Strumenti di automazione.






Elenco dei comandi/operazioni disponibili


Creazione/trasferimento di un dominio

                    ## this section specify batch options

                    batch.version: 4.0
                    batch.account: XXXXX-ovh
                    batch.referer: ma-ref-123456
                    batch.type: orderDomain
                    batch.auth.method: md5
                    batch.autopayment: yes

                    ## this section specify order

                    order.domain.name: ovh.com
                    order.domain.command: create    # can be: create | transfer | renew
                    order.offer: gold               # can be: gold | platine | diamond

                    ## this section specify owner

                    # give either contact.owner.id or contact.owner.<name|firstname|...>
                    contact.owner.legalform: corporation # can be: corporation | individual | association | other
                    contact.owner.vat:
                    contact.owner.name: XXXX
                    contact.owner.firstname: XXXXX
                    contact.owner.organisation: XXX
                    contact.owner.email: XXX@XXXX.net
                    contact.owner.address: XXX XXX XXX XXX
                    contact.owner.city: XXXXXX
                    contact.owner.zip: XXXXX
                    contact.owner.country: FR
                    contact.owner.language: fr
                    contact.owner.phone: +33.XXXXXXXX
                    contact.owner.fax:

                    ## this section specify contacts

                    contact.tech.id: ve174-ovh
                    # give either contact.tech.id or contact.tech.<name|firstname|...>
                    contact.admin.id: ve174-ovh
                    # give either contact.admin.id or contact.admin.<name|firstname|...>
                    contact.billing.id: ve174-ovh
                    # give either contact.billing.id or contact.billing.<name|firstname|...>

                    ## this section is mandatory for .fr

                    option.identification.method: birthPlace # can be: siren | inpi | birthPlace | afnicIdent
                    option.identification.legalName: XXX
                    option.identification.legalNumber: 123456789
                    option.identification.afnicIdent:
                    option.identification.birthDate: 01/01/2008
                    option.identification.birthCity: XXXXXX
                    option.identification.birthDepartement: XX
                    option.identification.birthCountry: FR

                    ## this section let you specify dns, not needed if you take a sharedHosting

                    option.dns.group: hosting # can be: hosting | dedicated | external
                    option.dns.master: dns12.ovh.net
                    option.dns.slave1: ns12.ovh.net
                    option.dns.slave2: XXXX.ovh.net 127.0.0.1
                    option.dns.slave3:
                    option.dns.slave4:

                    ## authinfo code for gTlds and .pl transfer

                    option.domain.authinfo: XXXXXXXXXXXXXXX

                    ## allow you protect your whois data in gtlds domain names

                    option.owo: yes
                        
                      






Rinnovo di un dominio

                    batch.version: 4.0
                    batch.account: XXXXX-ovh
                    batch.referer: ma-ref-123456
                    batch.type: orderDomain
                    batch.auth.method: md5
                    batch.autopayment: yes

                    order.domain.name: ovh.com
                    order.domain.command: renew

                    batch.auth.md5: b0a24f10d535d1b9ef40e50e97a0c312
                        
                      






Chiamata ad una funzione SOAPI: Modifica ai DNS di un dominio

                        batch.version: 4.0
                        batch.account: XXXXXX-ovh
                        batch.referer: ma-ref-123456
                        batch.type: soapi
                        batch.auth.method: md5
                        batch.autopayment: yes

                        soapi.method: domainDnsUpdate
                        soapi.param.domain: ovh.com
                        soapi.param.dns1: dns12.ovh.net 
                        soapi.param.dns2: ns12.ovh.net
                        
                      






Spiegazione dei metodi di autenticazione




Firma MD5


E' un metodo basato sul calcolo hash MD5 dell'email che vuoi inviare e sulla passphrase che hai inserito nel manager. Per utilizzare questo metodo è sufficiente:
  • indicare che desideri utilizzare il metodo MD5
    batch.auth.method: md5
  • calcolare l'hash in MD5 dell'email. Puoi utilizzare uno degli script in Perl o PHP forniti di seguito

  • aggiungere l'hash alla fine dell'email
    batch.auth.md5: 9b02cb2890ce787fdfeef72473a7a149

Script di generazione di MD5 in Perl

                         #!/usr/bin/perl
                         use strict;
                         use Digest::MD5 qw(md5_hex);

                         # fichier à signer
                         my $file = "email.txt";
                         
                         my $body;
                         open (F, $file);
                         while(<F>) {
                            $body.=$_;
                            print $_;
                         }
                         close(F);

                         my $passphrase = "MaPassPhraseQuiEstUnique";
                         my $texte_a_hasher = $passphrase.$body;
                         $texte_a_hasher =~ s/\s//g;

                         # génération du MD5
                         my $signature = md5_hex($texte_a_hasher);

                         $body .= "batch.auth.md5: $signature\n";
                         print $body;
                                  
                                  


Script di generazione di MD5 in PHP

                         <?
                         // ouverture du fichier source
                         $body = @file_get_contents("email.txt");

                         // PassPhrase saisie dans le MANAGER
                         $passphrase = 'MaPassPhraseQuiEstUnique';

                         $texte_a_hasher = preg_replace('/\s/','',$passphrase.$body);

                         //génération du MD5
                         $signature = md5($texte_a_hasher);
                         $body .= 'batch.auth.md5: '.$signature;

                         // Affichage du Mail à envoyer
                         echo "$body\n" ;
                         ?>
                                  
                                  



Tabella delle sezioni obbligatorie e opzionali


Le sezioni obbligatorie sono indicate da un mentre quelle opzionali riportano la nota 'opzione'.

creare trasferimento rinnovo soapi
batch
ordine
contatto
opzione opzione opzione
soapi






Conversione punti in un ordine di dominio


Batch


batch.version


E' necessario indicare il numero della versione

esempio:
batch.version: 4.0

batch.account


E' necessario indicare il NIC-Handle del buono d'ordine. Se desideri utilizzare il conto prepagato, le operazioni saranno effettuate su questo NIC-Handle.

esempio:
batch.account: XXXXXX-OVH

batch.referer


Potrai indicare una referenza per identificare la tua richiesta

esempio:
batch.referer: ma-ref-123456

batch.type


Indica il tipo di richiesta, seleziona "orderDomain" per creare o trasferire in OVH un dominio o "soapi" per richieste effettuate con le SOAPI.

esempio:
batch.type: orderDomain

batch.auth.method


I metodi di identificazione: md5, pgp, smime oppure plain. Per maggiori informazioni sui metodi di autenticazione, consulta la scheda tecnica del servizio di pre-pagamento.

esempio:
batch.auth.method: md5

batch.autopayment


E' necessario indicare se il buono d'ordine dovrà essere saldato utilizzando il conto prepagato

esempio:
batch.autopayment: yes






Ordine


order.domain.name


E' necessario indicare il dominio.

esempio:
order.domain.name: ovh.com

order.domain.command


E' necessario indicare il tipo di ordine per il dominio: creare, trasferimento oppure rinnovo.

esempio:
order.domain.command: create

order.hosting.type


E' necessario indicare il tipo di hosting: none per nessuno, 90plan, 720plan, mediaplan oppure xxlplan.

esempio:
order.hosting.type: xxlplan

order.offer


Occorre indicare il tipo d'offerta per il nome di dominio: Gold , Platinum oppure Diamond.

esmpio:
order.offer: diamond

order.resellerProfile


E' necessario indicare il tipo di rivenditore: none per nessuno, whiteLabel per marchio bianco e agente per agente.

esempio:
order.resellerProfile: none






Contatti


Questa sezione definisce i contatti del dominio:
  • proprietario (owner),
  • amministratore (admin),
  • tecnico (tech),
  • e fatturazione (billing).

contact.owner.id


Ti permette di definire il proprietario indicando un NIC-handle.

esempio:
contact.owner.id: XXXXXX-OVH


contact.owner.name
contact.owner.firstname
contact.owner.legalform
contact.owner.organisation
contact.owner.address
contact.owner.zip
contact.owner.city
contact.owner.country
contact.owner.phone
contact.owner.fax
contact.owner.email
contact.owner.language
contact.owner.vat


Ti permette di definire il proprietario indicandone tutte le informazioni.

esmpio:
                            contact.owner.name: MonNom contact.owner.firstname: MonPrénom contact.owner.legalform: individual contact.owner.organisation: OVH contact.owner.address: 140 Quai du Sartel contact.owner.city: Roubaix contact.owner.zip: 59100 contact.owner.country: FR contact.owner.phone: +33.123456789 contact.owner.fax: contact.owner.email: support@ovh.net contact.owner.language: fr contact.owner.vat:
                            

contact.admin.*
contact.tech.*
contact.billing.*


La procedura è identica per gli altri contatti.






Opzione


option.identification.method
option.identification.legalName
option.identification.legalNumber
option.identification.afnicIdent
option.identification.birthDate
option.identification.birthCity
option.identification.birthDepartement
option.identification.birthCountry


Questa sezione è obbligatoria per la creazione e il trasferimento di domini .fr .

esempio:
                            option.identification.method: birthPlace option.identification.legalName: OVH option.identification.legalNumber: 123456789 option.identification.afnicIdent: option.identification.birthDate: XX/XX/2009 option.identification.birthCity: MaVille option.identification.birthDepartement: 59 option.identification.birthCountry: FR
                            


option.dns.master
option.dns.slave1
option.dns.slave2
option.dns.slave3
option.dns.slave4
option.dns.slave5


Questa sezione permette di definire i DNS da utilizzare per la creazione o il trasferimento di un dominio.

esempio:
                            option.dns.master: dns12.ovh.net option.dns.slave1: ns12.ovh.net option.dns.slave2: option.dns.slave3: option.dns.slave4: option.dns.slave5:
                            


option.owo


Questa sezione permette di attivare il servizio OwO (protezione dei dati del Whois) per i vostri nomi a dominio .com, .net, .org, .info, .biz.

esempio:
                            option.owo: yes
                            


option.domain.authinfo


Questa sezione è utilizzata per indicare il codice AuthInfo obbligatorio per i trasferimenti di domini gTlds (.com, .net, .org, .info, .biz) e .pl .

esempio:
                            option.domain.authinfo: XXXXXXXXXXXXXXX
                            






Soapi


soapi.method
soapi.param.*


Questa sezione permette di chiamare semplicemente delle funzioni SOAPI. soapi.method indica il nome del metodo da utilizzare, il prefisso soapi.param. permette di definire tutti i parametri da passare alla funzione.

esempio:
                            soapi.method: zoneEntryAdd soapi.param.domain: ovh.com soapi.param.subdomain: sousdmaines soapi.param.fieldtype: A soapi.param.target: 127.0.0.1