Over
Techniek
Bewerkingen

OVH SOAPI


Ontdek de OVH API op basis van SOAP en WSDL. Klik hier.



Wat is het?

De PRE-PAYMENT dienst is een manier om de points te gebruiken, die u hebt verdiend of gekocht via uw loyalty of reseller account.
Het systeem is gebaseerd op het gewoonlijke bestelsysteem, of op het specialised order automation systeem.
100 Points op uw account is gelijk aan € 1,00 excl. BTW.



Tarieven

Een point op uw account, is gelijk aan een eurocent.
Om punten te kopen, moet u BTW betalen als u hiervoor belastingplichtig bent.




Het gebruiken van de points:

U kunt betalen voor uw bestellingen in points via het SoAPI systeem of het gewoonlijke bestelproces.
Met de regel "100 points= € 1,- excl. BTW", kunt u eenvoudig uitrekenen hoeveel punten u nodig heeft om uw bestelling te betalen.

Bijvoorbeeld: u heeft een bestelling voor een dedicated server 136,15 excl. btw (€164,74 incl. btw) . Deze kan ik betalen met 13.615 punten uit mijn account.



Resellers:

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.

Geautomatiseerde batch-mail


Dit systeem stelt u in gelegenheid om uw punten om te zetten in programma's en operaties uitvoeren op uw diensten.

De conversie proces gebeurt door het sturen van een opgemaakte e-mail naar het adres batch@ovh.com, of de kijker SOAPI. Deze mail moet overeenkomen met een syntax hieronder gedefinieerd en worden geviseerd door een van de volgende methode: wachtwoord, MD5 handtekening, PGP of SMIME.

Synoptische te volgen:
  • 1. Maak uw bestelling / transactie op de syntaxis hier gedefinieerd
  • 2. authenticeer uw bestelling op een van de volgende methoden: wachtwoord, MD5, PGP en SMIME
  • 3. Stuur uw bestelling / transactie via e-mail batch@ovh.com
    (Gebruik batch-test@ovh.com als u een test wilt uitvoeren)

Om uw e-mail te registreren, zijn hier de regels:
  • De pre-betalingssysteem Omvat niet de opgemaakte e-mailberichten en voelt als text / plain batch@ovh.com
  • Als je gebruik maakt van MD5 authenticatie, moeten de handtekeningen aan het einde van de e-mail text / plain toegevoegd worden.
  • Plak geen bevestiging.

Voel je vrij om het adres te gebruiken batch-test@ovh.com die u toelaat om de controle simuleren / operatie en dus vertrouwd met het mail systeem.

Een batch-mail wizard generator is tot uw beschikking in ManagerAfdeling Beheer> Space loyaliteit / reseller> Automatisering hulpmiddelen.






Lijst met beschikbare opdrachten/activiteiten


Het creëren van een domein / repatriëring van een domeinnaam

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






Vernieuwing van een domeinnaam

                    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
                        
                      






Bellen naar een SOAP-functie: Change DNS-domein

                        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
                        
                      






Uitleg van authenticatie methoden




Handtekening en MD5


Het is een methode die gebaseerd is op de berekening van de MD5-hash van de email die je stuurt en het wachtwoord die u hebt ingevoerd in de manager. Om alleen deze methode te gebruiken:
  • aangeven dat u de MD5 methode wilt gebruiken
    batch.auth.method: md5
  • Bereken de MD5-hash van deze e-mail. U kunt gebruik maken van een script in Perl of PHP, hieronder

  • toe te voegen aan het eind van het e-hash
    batch.auth.md5: 9b02cb2890ce787fdfeef72473a7a149

Script genereren van MD5 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 genereren van 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" ;
                         ?>
                                  
                                  



Tabel van de verplichte en optionele rubrieken


De verplichte rubrieken worden met een gemarkeerd en de optionele categorieën met 'optie'.

aanmaken verhuizen vernieuwen soapi
batch
order
contact
optie optie optie
soapi






Inwisselen van punten voor een bestelling van een domein


Batch


batch.version


U dient het versienummer aan te geven.

voorbeeld:
batch.version: 4.0

batch.account


U dient de nickhandle aan te geven voor de bestelbon. als u een prepaid account gebruikt, worden de handelingen op dit account gedaan.

voorbeeld:
batch.account: XXXXXX-OVH

batch.referer


U dient een referentie te geven voor uw factuur.

voorbeeld:
batch.referer: ma-ref-123456

batch.type


Het moet de aard van het verzoek om de mogelijke waarden zijn vermeld worden 'bestellen domein' Soapies voor de oprichting of overdracht van een domein, en''voor een Soapies gevoerd over het verzoek.

voorbeeld:
batch.type: orderDomain

batch.auth.method


type authenticatie: md5, pgp, smime of plain. Meer informatie over de authenticatie methoden beschikbaar op de pagina met de technische details voor een pre-paid service.

voorbeeld:
batch.auth.method: md5

batch.autopayment


U dient hier aan te geven welke bestelbon betaald moet worden door welke pre-paid gebruiker

voorbeeld:
batch.autopayment: yes






Order


order.domain.name


U dient de domain naam aan te geven.

voorbeeld:
order.domain.name: ovh.com

order.domain.command


Het moet de aard van de order gespecificeerd voor de domeinnaam worden aangegeven: aanmaken, verhuizen of vernieuwen.

voorbeeld:
order.domain.command: create

order.hosting.type


U dient het type hosting aan te geven: none gratis, 90plan, 720plan, mediaplan of xxlplan.

voorbeeld:
order.hosting.type: xxlplan

order.offer


Het moet worden vermeld het type van het aanbod van een domeinnaam: gold, platinum of diamond.

voorbeeld:
order.offer: diamond

order.resellerProfile


De aard van de Resellers moeten worden aangegeven. none gratis, whiteLabel Voor whitemark en Agent voor een agent.

voorbeeld:
order.resellerProfile: none






Contact


Dit hoofdstuk defineerd de contacten van het domein:
  • eigenaar (owner),
  • beheerder (admin),
  • technisch (tech),
  • en facturatie (billing).

contact.owner.id


stelt u in staat de eigenaar d.m.v. nichandle te defineren.

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


kunt u de eigenaar te definiëren onder vermelding van de volledige contactgegevens

voorbeeld:
                            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.*


Het systeem werkt voor de andere contacten op dezelfde manier.






Optie


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


Deze sectie is voor het creëren en overdragen .fr domeinen vereist.

voorbeeld:
                            optie.identificatie.methode: Geboorteplaats optie.identificatie.achternaam: OVH optie.identificatie.achternaam:123456789 optie.identificatie.afnicIdent: optie.identificatie.geboortedatum: XX/XX/2009 optie.identificatie.geboorteplaats: MaVille optie.identificatie.birhtDepartement: 59 optie.identificatie.geboorteland: FR
                            


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


Deze sectie laat u toe voor de oprichting of overdracht van het gebruik van DNS-domeinen.

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


Deze sectie laat u de dienst owo (het achterhouden van gegevens in de Whois activeren) zo compatibel domeinen (bijv. .com, .net, .org, .info...) te activeren.

voorbeeld:
                            option.owo: yes
                            


option.domain.authinfo


Deze sectie laat je de code aan te geven AUTHINFO vereist voor de overdracht van gTLD domeinnaam (.com, .net, .org, .info, .biz) en .pl .

voorbeeld:
                            option.domain.authinfo: XXXXXXXXXXXXXXX
                            






Soapi


soapi.method
soapi.param.*


In dit gedeelte kunt u gewoon bellen SOAP-functies. soapi.method Hiermee geeft u de naam van de methode welke worden gebruikt om - het voorvoegsel soapi.param. om alle parameters vast te leggen door te geven aan de functie.

voorbeeld:
                            soapi.methode: zoneEntryAdd soapi.param.domein: ovh.com soapi.param.subdomein: sousdmaines soapi.param.fieldtype: A soapi.param.target: 127.0.0.1