Tietoa
Tekniikkaa
Käyttö

SOAPI OVH


Tutustu OVH:n API-sovellukseen, joka perustana ovat SOAP ja WSDL. Klikkaa tästä.



Mikä se on?

Prepaid-palvelun avulla voi maksaa tilaukset kanta-asiakaspisteillä.
Pisteillä voi maksaa kaikki OVH:n sivuilla tehdyt tilaukset, jos kanta-asiakastilillä on riittävästi pisteitä.
100 pistettä vastaa 1 € (veroton hinta).



Hinnasto

1 piste vastaa 0,01 € (veroton hinta).
Pisteiden ostamiseksi täytyy maksaa ALV, jos ostaja on arvonlisäverovelvollinen.




Pisteiden käyttö:

Voit maksaa tilauksia pistesysteemin kautta tai maksaa tavallisen tilauksen pisteillä, jos pisteitä on riittävästi.
Säännöllä "100 pistettä = 1 € veroton hinta", näet helposti, montako pistettä tarvitaan tilauksesi maksamiseen.

Esimerkiksi: Minulla on tilaus dedikoidulle palvelimelle 168,83 . Voin maksaa 13 615 pistettä tililtäni.



Jälleenmyyjät:

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.

Batch-mail automatisointi


Järjestelmällä voit muuntaa tilauspisteesi ja suorittaa toimenpiteitä palveluillesi

Muunnosprosessi tehdään lähettämällä muotoiltu sähköposti osoitteeseen batch@ovh.com, tai käyttäen SOAPI. Tämän sähköpostin tulee vastata alla määriteltyä syntaksia ja se tulee olla autentikoitu allaolevalla tekniikalla: salasana, MD5-allekirjoitus, PGP ja MIME.

Toimintaohjeet:
  • 1. luo tilauksesi tai toimenpiteesi seuraamalla alla määriteltyä syntaksia
  • 2. autentikoi tilauksesi yhdellä seuraavista tekniikoisa: salasana, MD5-allekirjoitus, PGP tai SMIME
  • 3. lähetä tilauksesi/toimenpiteesi sähköpostilla osoitteeseen batch@ovh.com
    (käytä batch-test@ovh.com jos haluat testata sitä)

Alla on säännöt viestin luomiseen:
  • Pre-paid järjestelmä ei tue muotoiltuja viestejä vaan ne pitää lähettää perus tekstimuodossa. batch@ovh.com
  • Mikäli käytät MD5-tunnistusta, allekirjoitukset on lisättävä sähköpostiviestin loppuun text/plain -muotoisena.
  • Älä liitä liitetiedostoa.

Älä epäröi käyttää osoitetta batch-test@ovh.com jolla voit simuloida tilauksen/toimenpiteen ja näin tutustua sähköpostijärjestelmään.

Batch-mail on käytettävissäsi Hallintaan, Hallinnointi > Kanta-asiakastili > Automatisointityökalut.






Tilaukset/saatavilla olevien toimitojen lista


Verkkotunnuksen rekisteröinti / siirtäminen

                    ## 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
                        
                      






Verkkotunnuksen uusiminen

                    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
                        
                      






SOAPI funtion kutsu : Muuta verkkotunnuksen DNS asetuksia

                        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
                        
                      






Autentikointitapojen selitykset




MD5-allekirjoitus


Menetelmä perustuu MD5 hashin laskemiseen ja koodisanaan jonka olet syöttänyt hallintaan. Tätä menelmää käyttäessäsi :
  • osoita että haluat käyttää MD5 menetelmää
    batch.auth.method: md5
  • laske tämän e-mailin MD5 hash. Voit käyttää Perliä tai PHP:tä, ovat alla annettu

  • lisää e-mailin loppuun hash
    batch.auth.md5: 9b02cb2890ce787fdfeef72473a7a149

Scripti MD5:n luomikseksi perlillä

                         #!/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;
                                  
                                  


Scripti MD5:n luomiseksi PHP:llä

                         <?
                         // 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" ;
                         ?>
                                  
                                  



Taulukko pakollisista ja valinnaisista osioista


Pakolliset osiot on merkitty ja valinnaiset osiot 'option'.

create transfer renew soapi
batch
tilaa
contact
lisäpalvelu lisäpalvelu lisäpalvelu
soapi






Pisteiden muuttaminen verkkotunnuksen ostamiseksi


Batch


batch.version


Ilmoita versionumero.

esimerkki:
batch.version: 4.0

batch.account


Ilmoita asiakastunnus. Jos käytät prepaid-tiliä, operaatiot suoritetaan tiliin liittyvällä asiakastunnuksella.

esimerkki:
batch.account: XXXXXX-OVH

batch.referer


Ilmoita pyyntöön liittyvä viite.

esimerkki:
batch.referer: ma-ref-123456

batch.type


Sinun täytyy valita sovellustyyppi. Mahdollisia arvoja ovat 'orderDomain' verkkotunnuksen luontiin, uusintaan tai siirtoon ja 'soapi' SOAPIa käyttävälle haulle.

esimerkki:
batch.type: orderDomain

batch.auth.method


Autentikointimenetelmät : md5pgpsmime tai plain. Lisätietoa autentikoinnista, katso Prepaid palvelun tekniset tiedot.

esimerkki:
batch.auth.method: md5

batch.autopayment


Sinun tulee valita jos haluat käyttää prepaid tiliä maksuun.

esimerkki:
batch.autopayment: yes






Order


order.domain.name


Ilmoita verkkotunnus.

esimerkki:
order.domain.name: ovh.com

order.domain.command


Sinun tulee ilmaista verkkotunnustilauksen tyyppi : createtransfer tai renew.

esimerkki:
order.domain.command: create

order.hosting.type


Ilmoita webhotelli: none ei millekään, 90plan720planMediaplan tai xxlplan.

esimerkki:
order.hosting.type: xxlplan

order.offer


Verkkotunnuksen tyyppi pitää määritellä: GoldPlatinum tai Diamond.

esimerkki:
order.offer: diamond

order.resellerProfile


Ilmoita jälleenmyyjä: none ei millekään, whiteLabel white labelille ja edustaja agentille.

esimerkki:
order.resellerProfile: none






Asiakaspalvelu


Tässä osiossa ilmoitetaan verkkotunnuksen yhteyshenkilöt:
  • haltija (owner),
  • admin (admin),
  • tekninen yhteyshenkilö (tech),
  • ja laskutusyhteyshenkilö (billing).

contact.owner.id


ilmoittaaksesi haltijan syöttämällä hänen asiakastunnuksensa.

esimerkki:
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


Ilmoita haltija syöttämällä hänen yhteystietonsa.

esimerkki:
                            contact.owner.name: MinunSukunimeni contact.owner.firstname: MinunEtunimeni contact.owner.legalform: yksityishenkilo contact.owner.organisation: OVH contact.owner.address: Hämeentie 5 contact.owner.city: Helsinki contact.owner.zip: 00530 contact.owner.country: FI contact.owner.phone: +358-40-1234567 contact.owner.fax: contact.owner.email: support@ovh.net contact.owner.language: fi contact.owner.vat:
                            

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


Järjestelmä on sama muille yhteyshenkilöille.






Lisäpalvelu


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


Tämä osio on pakollinen fr-verkkotunnuksen rekisteröimiseksi ja siirtämiseksi.

esimerkki:
                            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


Tämä osio sallii sinun asettaa DNS toimimaan verkkotunnuksen luomisen tai siirron hyväksi.

esimerkki:
                            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


Täältä voit aktivoida OwO palvelun (Identiteetin suojelu) seuraaville verkkotunnuksille .com, .net, .org, .info, .biz.

esimerkki:
                            option.owo: yes
                            


option.domain.authinfo


Täältä voit määritellä AUTHINFO koodin jota tarvitaan verkkotunnuksen siirtämiseen. (.com, .net, .org, .info, .biz) ja .pl .

esimerkki:
                            option.domain.authinfo: XXXXXXXXXXXXXXX
                            






Soapi


soapi.method
soapi.param.*


Tästä kohdasta voit helposti kutsu SOAPI-funktioita soapi.method kertoo metodin nimen, prefixin soapi.param. määrittääkseen kaikki parametrit mitä funktiolle välitetään.

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