Apie
Techninė
Operacijos

SOAPI OVH


Susipažinkite su OVH API, pagrįsta SOAP ir WSDL. Spragtelėkite čia.



Kas tai yra?

IŠANKSTINIO APMOKĖJIMO paslauga yra skirta lojalumo ar perpardavėjo sąskaitoje sukauptų ar nupirktų taškų išleidimo įrankis.
Šios sistemos pagrindas yra arba klasikinė užsakymo sistema, arba speciali užsakymų automatizavimo sistema.
100 taškų atitinka 1 € be PVM.



Įkainiai

Vienas taškas sąskaitoje atitinka vieną euro centą be PVM.
Užsakymą apmokant taškais, PVM būna įskaičiuotas.




Taškų naudojimas:

Galite apmokėti užsakymus, atliktus naudojant specialią ar paprastą sistemą.
Pagal formule "100 taškų = 1 € be PVM", jūs galite užsisakyti paslaugas už susitaupytus taškus.

Pavyzdžiui: užsisakote serverį už 136,15 (164,74€ su PVM) . Sumokate 13 615 taškais iš savo išankstinio mokėjimo sąskaitos.



Perpardavėjai:

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.

Automatizavimas per batch-mail


Ši sistema leidžia automatiškai atlikti užsakymus ar kitas paslaugų operacijas naudojant lojalumo taškus.

Operacija atliekama išsiunčiant atitinkamai suformuotą laišką nurodytu el. adresu batch@ovh.com arba naudojant SOAPI. Laiškas turi būti paruoštas naudojant žemiau nurodytą sintaksę ir patvirtintas slaptažodžiu, MD5, PGP arba SMIME parašu.

Tvarka:
  • 1. sukurkite užsakymą/operaciją ir naudokite žemiau pateiktą sintaksę
  • 2. patvirtinkite užsakymą slaptažodžiu ir MD5, PGP arba SMIME parašu
  • 3. išsiųskite savo užsakymą/operaciją el. paštu batch@ovh.com
    (naudokite batch-test@ovh.com , jeigu pageidaujate atlikti testavimą)

Laiškui sukurti naudokite šias taisykles:
  • Išankstinio mokėjimo sistema priima tik tinkamai paruoštus 'plain text' formato pranešimus, nusiųstus į batch@ovh.com
  • Jeigu naudojate MD5 parašą, jis turi būti nurodytas 'plain text' formatu laiško pabaigoje.
  • Nepridėkite jokiu priedų prie laiško.

Taip pat galite naudoti adresą batch-test@ovh.com , kuris tik simuliuoja užsakymą/operaciją ir taip susipažinkite su sistemos veikimu neatlikdami tikrų veiksmų.

Batch-mail generatorių rasite tvarkytuve skyriuje Administravimas > Lojalumo sąskaita > Automatizavimo įrankiai.






Galimų užsakymų/operacijų sąrašas


Domeno sukūrimas / perkėlimas

                    ## 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.hosting.type: 720plan     # can be: none | 90plan | 720plan | xxlplan | mediaplan 
                    order.offer: gold               # can be: gold | platine | diamond
                    order.resellerProfile: agent    # can be: none | whiteLabel | agent

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






Domeno atnaujinimas

                    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
                        
                      






Naudojama SOAPI funkcija: Domeno DNS keitimas

                        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
                        
                      






Autentifikavimo būdų paaiškinimas




MD5 parašas


Tai yra būdas paremtas jūsų siunčiamo laiško ir tvarkytuve nurodyto slaptažodžio MD5 hash skaičiavimu, norint naudoti šį būdą, pakanka:
  • Nurodyti, kad jūs norite naudoti MD5 būdą
    batch.auth.method: md5
  • Suskaičiuoti el. laiško MD5 hash. Galite naudoti žemiau pateiktus Perl arba PHP scenarijus

  • Apskaičiuotą MD5 hash pridėkite laiško pabaigoje:
    batch.auth.md5: 9b02cb2890ce787fdfeef72473a7a149

Perl MD5 generavimo scenarijus

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


PHP MD5 generavimo scenarijus

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



Privalomų ar papildomų skyrių lentelė


Privalomi skyriai pažymėti , papildomi skyriai pažymėti žodžiu „pasirinktinai“.

createperkėlimasnaujinimassoapi
batch
užsakymas
kontaktai
pasirinktinaipasirinktinaipasirinktinai
soapi






Taškų konvertavimas į domeno užsakymą


Batch


batch.version


Reikia nurodyti versijos numerį.

pavyzdys:
batch.version: 4.0

batch.account


Užsakymui privalote nurodyti kliento identifikatorių. Jeigu naudojate išankstinio apmokėjimo sąskaitą, operacijos bus atliekamos su šiuo identifikatoriumi.

pavyzdys:
batch.account: XXXXXX-OVH

batch.referer


Galite nurodyti užklausos identifikavimo sąryšį.

pavyzdys:
batch.referer: ma-ref-123456

batch.type


Reikia nurodyti užklausos tipą, galimos reikšmės: 'orderDomain' - domeno sukūrimui ar perkėlimui, ir 'soapi' - SOAPI užklausoms.

pavyzdys:
batch.type: orderDomain

batch.auth.method


identifikacijos metodo tipas: md5, pgp, smime arba plain text. Norėdami gauti daugiau informacijos apie identifikacijos metodus, skaitykite išankstinio apmokėjimo paslaugos techninius duomenis.

pavyzdys:
batch.auth.method: md5

batch.autopayment


Reikia nurodyti, ar užsakymas bus apmokamas naudojant išankstinio apmokėjimo sąskaitą.

pavyzdys:
batch.autopayment: yes






Order


order.domain.name


Reikia nurodyti domeną.

pavyzdys:
order.domain.name: ovh.com

order.domain.command


Reikia nurodyti domeno užsakymo tipą: create, perkėlimas arba naujinimas.

pavyzdys:
order.domain.command: create

order.hosting.type


Reikia nurodyti svetainių talpinimo tipą: none niekam, 90plan, 720plan, „mediaplan“ arba xxlplan.

pavyzdys:
order.hosting.type: xxlplan

order.offer


Reikia nurodyti pasiūlymo tipą domenui: „Gold“, „Platinum“ arba „Diamond“.

pavyzdys:
order.offer: diamond

order.resellerProfile


Reikia nurodyti perpardavėjo tipą: none niekam, whiteLabel bevardžiams ženklams ir „agent“ agentams.

pavyzdys:
order.resellerProfile: none






Kontaktai


Šiame skyriuje nurodomi domeno kontaktai:
  • savininkas (owner),
  • administratorius (admin),
  • technikas (tech),
  • ir sąskaitų (billing).

contact.owner.id


galite nustatyti savininką nurodydami identifikatorių.

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


Galite nustatyti administratorių įvesdami visą informaciją.

pavyzdys:
                            contact.owner.name: JūsųVardas contact.owner.firstname: JūsųPavardė contact.owner.legalform: fizinis asmuo contact.owner.organisation: OVH contact.owner.address: A. Jakšto 6a-16 contact.owner.city: Vilnius contact.owner.zip: 01105 contact.owner.country: LT contact.owner.phone: +370.12345678 contact.owner.fax: contact.owner.email: support@ovh.lt contact.owner.language: lt contact.owner.vat:
                            

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


Kitų kontaktų sistema identiška.






Pasirinkimas


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


Šis skyrius būtinas .fr domeno sukūrimui ar perkėlimui.

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


Šiame skyriuje galite nurodyti DNS, kurie bus naudojami domenų kūrimui ar perkėlimui.

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


Šiame skyriuje galite įjungti OwO (Whois duomenų apsaugą) savo domenams .com, .net, .org, .info, .biz.

pavyzdys:
                            option.owo: yes
                            


option.domain.authinfo


Šiame skyriuje galite nurodyti authinfo kodą, kurio reikia gTlds (.com, .net, .org, .info, .biz) ir .pl domenų perkėlimui.

pavyzdys:
                            option.domain.authinfo: XXXXXXXXXXXXXXX
                            






Soapi


soapi.method
soapi.param.*


Šiame skyriuje galite paprastai iššaukti SOAPI funkcijas. soapi.method pradžioje nurodykite, kurį metodą naudoti soapi.param. apibrėžia funkcijai perduodamus parametrus.

pavyzdys:
                            soapi.method: zoneEntryAdd soapi.param.domain: ovh.com soapi.param.subdomain: subdomenai soapi.param.fieldtype: A soapi.param.target: 127.0.0.1
                            







Tęsdami naršymą svetainėje Jūs sutinkate su slapukų (cookies) naudojimu, skirtu sklandžiam naršymo užtikrinimui ir lankytojų statistikai. Daugiau apie slapukų valdymą.
Ok