1 Overzicht. 1.1 Versie opmerkingen. 2 Principe van de API

Networking4all API Specificatie en Documentatie Versie 1.0.30 27 maart 2013

Inhoudsopgave 1 Overzicht 1.1 Versie opmerkingen

2 Principe van de API

7 7

12

2.1 Basis werking

12

2.2 Connecteren naar de API

12

2.2.1 Staging omgeving

12

2.2.2 Test en Live omgeving

12

2.3 De bestelling van een SSL certificaat

13

2.4 De bestelling van een Domeinnaam

13

3 Web service details: Relaties 3.1 createRelation

15 15

3.1.1 createRelation request

15

3.1.2 createRelation Response

16

3.2 updateRelation

17

3.2.1 updateRelation request

17

3.2.2 updateRelation Response

18

3.3 deleteRelation

19

3.3.1 deleteRelation Request

19

3.3.2 deleteRelation Response

19

3.4 getRelation

19

3.4.1 getRelation Request

20

3.4.2 getRelation Response

20

3.5 getRelationContacts

21

3.5.1 getRelationContacts Request

21

3.5.2 getRelationContacts Response

22

3.6 addRelationContacts

23

3.6.1 addRelationContacts Request

23

3.6.2 addRelationContacts Response

24

3.7 removeRelationContacts

24

3.7.1 removeRelationContacts Request

24

3.7.2 removeRelationContacts Response

25

3.8 getRelationResellerClients

25

3.8.1 getRelationResellerClients Request

25

3.8.2 getRelationResellerClients Response

25

© 2013 Networking4all - www.networking4all.com

pagina 2 van 99

3.9 addRelationResellerClients

27

3.9.1 addRelationResellerClients Request

27

3.9.2 addRelationResellerClients Response

27

3.10 removeRelationResellerClients

28

3.10.1 removeRelationResellerClients Request

28

3.10.2 removeRelationResellerClients Response

28

4 Web service details: Producten 4.1 getProduct

30 30

4.1.1 getProduct Request

30

4.1.2 getProduct Response

30

4.2 getProducts

31

4.2.1 getProducts Request

31

4.2.2 getProducts Response

31

5 Web service details: SSL Certificaten 5.1 checkSSLCertificateCSR

33 33

5.1.1 checkSSLCertificateCSR Request

33

5.1.2 checkSSLCertificateCSR Response

33

5.2 getSSLCertificateApproverList

34

5.2.1 getSSLCertificateApproverList Request

34

5.2.2 getSSLCertificateApproverList Response

34

5.3 orderSSLCertificate

34

5.3.1 orderSSLCertificate Request

34

5.3.2 orderSSLCertificate Response

35

5.4 resendEmailSSLCertificate

36

5.4.1 resendEmailSSLCertificate Request

36

5.4.2 resendEmailSSLCertificate Response

36

5.5 getSSLCertificateOrder

37

5.6 getSSLCertificateOrderList

37

5.7 getSSLCertificate

37

5.7.1 getSSLCertificate Request

37

5.7.2 getSSLCertificate Response

37

5.8 getSSLCertificateList

39

5.8.1 getSSLCertificateList Request

39

5.8.2 getSSLCertificateList Response

40

5.9 replaceSSLCertificate

42

5.9.1 replaceSSLCertificate Request

42

5.9.2 replaceSSLCertificate Response

42

5.10 updateSSLCertificate


43

pagina 3 van 99

5.10.1 updateSSLCertificate Request

43

5.10.2 updateSSLCertificate Response

43

5.11 changeSANSSLCertificate

44

5.11.1 changeSANSSLCertificate request

44

5.11.2 changeSANSSLCertificate

44

6 Web service details: Domeinnamen 6.1 checkDomain

45 45

6.1.1 checkDomain Request

45

6.1.2 checkDomain Response

45

6.2 orderDomain

46

6.2.1 orderDomain Request

46

6.2.2 orderDomain Response

46

6.3 nameServerChange

47

6.3.1 nameServerChange Request

47

6.3.2 nameServerChange Response

47

6.4 getDomainOrder

48

6.5 getDomain

48

6.5.1 getDomain Request

48

6.5.2 getDomain Response

48

6.6 getDomainList

49

6.6.1 getDomainList Request

49

6.6.2 getDomainList Response

49

6.7 updateDomain

50

6.7.1 updateDomain Request

50

6.7.2 updateDomain Response

51

6.8 cancelDomain

51

6.8.1 cancelDomain Request

51

6.8.2 cancelDomain Response

52

6.9 getDnsRecords

52

6.9.1 getDnsRecords Request

52

6.9.2 getDnsRecords Response

52

6.10 addDnsRecords 6.10.1 addDnsRecords Request

53 53

6.10.2 addDnsRecords Response 53 6.11 updateDnsRecords

54

6.11.1 updateDnsRecords Request

54

6.11.2 updateDnsRecords Response

54

6.12 deleteDnsRecords 6.12.1 deleteDnsRecords Request


55 55

pagina 4 van 99

6.12.2 deleteDnsRecords Response

7 Overige API Informatie

55

57

7.1 Notatie

57

7.2 De requestHeader

57

7.3 De responseHeader

57

7.3.1 Resultaat codes

58

7.3.2 Waarschuwing codes

58

7.3.3 Fout codes

58

7.4 Veld definities

59

7.5 Code voorbeelden SSL Certificaten

66

7.5.1 Bedrijf aanmaken

66

7.5.2 Contact aanmaken

68

7.5.3 Check de CSR

69

7.5.4 Het Approver Email adres

70

7.5.5 SSL Certificaat bestellen

70

7.5.6 Order the SSL Certificate (DV) with automatic Domain Approval

71

7.5.7 Opnieuw inzenden of wijzigen van het Approver Email adres

72

7.5.8 Een SSL Certificaat vervangen

73

7.5.9 Procedure voor het bestellen van een SAN certificaat

73

7.5.10 Het verkrijgen van de ApproverList voor een SAN certificaat

74

7.5.11 Bestelling van het SAN certificaat

75

7.5.12 Raadpleeg de API voor de status van de bestelling en het certificaat

76

7.5.13 Raadpleeg de API voor een lijst met SSLCerticates bestellingen

76

7.5.14 Wijzig uw malware scan opties

77

7.5.15 Vraag een On-Demand-Scan aan

77

7.5.16 Voeg een extra SAN naam toe aan uw certificaat.

78

7.5.17 Order a GlobalSign PersonalSign certificate.

78

7.5.18 Bestel een GlobalSign CodeSigning certificaat.

79

7.6 Code voorbeelden domeinnamen

80

7.6.1 Maak een nieuw bedrijf aan

80

7.6.2 Een contactpersoon aanmaken

81

7.6.3 Controleer de beschikbaarheid van de domeinnaam

83

7.6.4 Bestel een domeinnaam

83

7.6.5 De nameServers veranderen

84

7.6.6 Query the API for your domain Order status and domain info

85

7.6.7 Raadpleeg de API voor een lijst met Domeinnaam bestellingen

85

7.6.8 Update domeinnaam handles.

86

7.6.9 Opzeggen domeinnaam

86

7.6.10 Haal DNS records op van een domein

87

7.6.11 Voeg één of meerdere DNS records toe aan een domein

87


pagina 5 van 99

7.6.12 Update één of meerdere bestaande DNS records van een domein

88

7.6.13 Verwijder één of meerdere bestaande DNS records van een domein

89

7.7 UTF-8 encoding en decoding

8 Product informatie 8.1 Product codes

89

90 90

8.1.1 DV (Domain Validatie) SSL Certificaten

90

8.1.2 OV (Organisation Validatie) SSL Certificaten

90

8.1.3 EV (Extended Validation) SSL Certificaten

91

8.1.4 Client certificaten

92

8.1.5 Client certificaten verplichte velden (GlobalSign)

92

8.2 Productcodes domeinnamen (Hosting)

92

8.3 Status codes

93

8.3.1 Relevante status codes bij een SSL Certificaat bestelling

93

8.3.2 Substatus codes voorSSL Certificaat aanvragen

93

8.3.3 Status codes voor controleren domeinnamen

94

8.3.4 Relevante status codes bij een Domeinnaam bestelling

95

8.4 Extra Services 8.4.1 Malware scan

95 95

9 Het API control panel

97

9.1 Overzichtsscherm

97

9.2 Detailscherm

98


pagina 6 van 99

1 Overzicht Networking4all biedt zijn partners een Simple Object Access Protocol (SOAP) API (Application Programming Interface) voor het real-time beheer van relaties en producten en voor het bestellen van SSL Certificaten en domeinnamen. API Clients kunnen onder andere de volgende opdrachten uitvoeren: nieuwe relaties aanmaken, relaties bewerken, informatie opvragen over relaties, SSL Certificaten bestellen of vervangen en domeinnamen aanvragen. Deze documentatie bevat alle noodzakelijke informatie om de diensten van Networking4all te integreren in de partner website.

1.1 Versie opmerkingen Versie 1.0.30 (27 maart 2013) •Prijsaanpassingen van SSL Certificaten in productenoverzicht toegepast. Zie sectie 8.1.1, 8.1.2 en 8.1.3 voor meer informatie. •Wijziging in deleteDNSRecords gemaakt. Zie sectie 6.12.1 voor meer informatie. Versie 1.0.29 (3 december 2012) DNS beheer toegevoegd. • getDnsRecords functie toegevoegd, zie sectie 6.9 voor meer details. Zie sectie 7.6.10 voor voorbeeldcode. • addDnsRecords functie toegevoegd, zie sectie 6.10 voor meer details. Zie sectie 7.6.11 voor voorbeeldcode. • updateDnsRecords functie toegevoegd, zie sectie 6.11 voor meer details. Zie sectie 7.6.12 voor voorbeeldcode. • deleteDnsRecords functie toegevoegd, zie sectie 6.12 voor meer details. Zie sectie 7.6.13 voor voorbeeldcode. Versie 1.0.28 (16 juni 2012) •

•

Automatische DV Approver toegevoegd in de orderSSLCertificate en replaceSSLCertificate functies voor alle Symantec, GeoTrust, Thawte en geselecteerde Networking4all domeingevalideerde (DV) producten. Dit is een optie die u nodig heeft om het bestand te gebruiken (zie de optie block in de aanvraag). Het antwoord dat u krijgt zal de fileName en fileContent zijn, welke u nodig heeft om in het bestand te zetten en deze te kopiëren naar de publieke root van je website. Symantec zal dit bestand kiezen en wanneer gevonden en juist bevonden zal de certificaataanvraag worden goedgekeurd en worden uitgegeven. Zie paragrafen 5.3 en 5.9 voor meer informatie. Producten die worden ondersteund zijn te vinden in paragraaf 8.1.1. en zijn aangeduid met (bestand/file) in de approver kolom. Code voorbeelden zijn te vinden in paragraaf 7.5.6. Renewal optie toegevoegd aan orderSSLCertificate. U dient de orderKind = renewal moeten specificeren en het tracenummer van de oorspronkelijke bestelling op moeten geven voor een renewal. Zie paragraaf 5.3 voor meer informatie.

Versie 1.0.27 (24 april 2012) •

• •

De <sslsubstatusses> structuur toegevoegd aan de getSSLCertificate en getSSLCertificateList functies voor de toegevoegde substatussen. Dit geeft u de mogelijkheid om de actuele status van uw SSL Certificaat te zien tijdens het bestelproces. Zie paragraaf 5.7 en 5.8 voor meer details. Een lijst met substatussen toegevoegd welke mogelijk zijn in het nieuwe <sslsubstatusses> structuur. Zie paragraaf 8.3.2 voor meer informatie. De getProducts aanvraag toegevoegd. Dit maakt het mogelijk om een lijst met productcodes en -namen op te vragen en in het geval van een SSL Certificaat ook de merknaam. U dient een type aan te geven voor deze functie (SSL, domeinen, hosting), waarmee u een productlijst krijgt aangeleverd zonder verdere informatie. Zie paragraaf 4.2 voor meer informatie.


pagina 7 van 99

Versie 1.0.26 (20 februari 2012) •

•

• • •

• • • • •

Detailstructuur toegevoegd aan de getProduct, getSSLCertificate en getSSLCertificateList functies. Dit geeft u informatie over het SSL product zoals mailvalidation = 1, ev = 0 etc. Zie paragraaf 4.1.2, 5.7.2 en 5.8.2 voor meer informatie. Velden aan het orderSSLCertificate toegevoegd voor GlobalSign PersonalSign en CodeSigning certificaten. Zie paragraaf 5.3.1 voor meer details. Zie paragraaf 8.1.4 en 8.1.5 voor productCodes en voor de verplichte velden bij de verschillende certificaten. pickupPassword veld toegevoegd aan het orderSSLCertificate antwoord. Dit is noodzakelijk voor GlobalSign PersonalSign en CodeSigning certificaten. Zie paragraaf 5.3.2 voor meer informatie. Update van de velden met definities voor de velden van GlobalSign PersonalSign en CodeSigning certificaten, zie paragraaf 7.4 voor meer informatie. Update van de code voorbeelden voor het bestellen van een SAN certificaat, aangezien het niet langer verplicht is om een op te geven. Zie paragraaf 7.5.9 en 7.5.10 voor meer informatie. Voorbeeldcode toegevoegd voor een GlobalSign PersonalSign aanvraag. Zie paragraaf 7.5.16 voor meer informatie. Voorbeeldcode toegevoegd voor een GlobalSign CodeSigning aanvraag. Zie paragraaf 7.5.17 voor meer informatie. Update van de productCodes voor de Business Pro SSL en Business Pro SSL SAN certificaten in paragraaf 8.1.3. productCodes toegevoegd voor Client certificaten. Zie paragraaf 8.1.4 voor meer informatie. Een tabel met verplichte handelingen voor GlobalSign PersonalSign en CodeSigning certificaten toegevoegd. Zie paragraaf 8.1.5 voor meer informatie.

Versie 1.0.25 (21 november 2011) • • •

type en currency velden toegevoegd aan de getProduct, getSSLCertificate en getSSLCertificateList functies. Zie de fee structuur. Setup structure is hiermee DEPRECATED (verouderd). De setup kosten worden nu terug gegeven in de fee strucuur, met het type setup. BELANGRIJK: Er is nu een staging omgeving beschikbaar voor het testen van de laatste API wijzigen en het aanpassen van uw code. Zie sectie 2.2 voor meer informatie.

Versie 1.0.24 (22 augustus 2011) • • •

changeSANSSLCertificate functie toegevoegd. Hiermee kunt u SAN namen toevoegen en verwijderen aan uw SSL Certificaat. Zie secties 5.11 en 7.5.15 voor meer informatie. Status veld toegevoegd aan de updateDomain for noautorenew en autorenew. Zie sectie 6.7.1 voor meer informatie. Preregistration structuur toegevoegd aan de orderDomain voor pre-registration van verschillende nieuwe tld's. Zie sectie 6.2.1. voor meer informatie.

Versie 1.0.23 (29 maart 2011) • •

•

•

Uitleg toegevoegd over het aanmaken van company en contact relaties met de createRelation functie. Zie sectie 3.1 voor meer informatie. Verandering in het handle veld in de createRelation functie. Dit veld is niet langer verplicht bij het creeren van een contact relatie. Wanneer u een company handle opgeeft, dan word de contact relatie gekoppeld aan de company relatie. Dit is de beste manier om nieuwe contacten aan te maken. Wanneer u met een systeem werkt waarin het contact en bedrijf gekoppeld zijn kunt u de handle achterwege laten. Het contact zal NIET worden gekoppeld aan een specifiek bedrijf, maar aan uw reseller account. Veranderingen in de createRelation en updateRelation functies betreffende adresgegevens. De velden street, streetNumber en streetNumberExtension zijn DEPRECATED (verouderd), gebruik in plaats hiervan street1. Het gehele adres inclusief street, streetNumber en streetNumberExtension zou nu in street1 moeten komen. Als u meer adresgegevens heeft kunt u optioneel street2 en street3 gebruiken. Zie secties 3.1 en 3.2 voor meer informatie. Veranderingen in de createRelation en updateRelation functies betreffende telefoon, fax en mobiele telefoonnummers. De phone, fax en mobile structuren zijn DEPRECATED (verouderd). Gebruik in


pagina 8 van 99

•

•

•

• •

plaats hiervan phoneNumber, faxNumber en mobileNumber. Zie secties 3.1 en 3.2 voor meer informatie. Veranderingen in de getRelation functie. U kunt (company) name, of (contact) firstname/lastname gebruiken om een relatie op te vragen. Deze moet honderd procent overeenkomen. Zie sectie 3.4 voor meer informatie. Veranderingen in de getRelation functie response. De velden street1, street2 street3, phoneNumber, faxNumber, mobileNumber worden meegegeven vanwege de laatste wijzigingen. Zie sectie 3.4 voor meer informatie. Veranderingen in de product naamgeving van de Networking4all SSL Certificaten. Lite, Basic en Pro zijn nu Regular Lite, Regular Basic en Regular Pro. Dit zijn de DV SSL Certifcaten. Zie sectie 8.1.1 voor meer informatie. Nieuwe producten in de Networking4all SSL Certificaten. In de Business Basic series. Dit zijn OV certificaten. Zie sectie 8.1.2 voor meer informatie. Nieuw producten in de Networking4all SSL Certificaten. In de Business Pro serie. Dit zijn EV certificaten. Zie sectie 8.1.2 voor meer informatie.

Versie 1.0.22 (23 november 2010) • • • • •

extraServices structuur toegevoegd aan de getSSLCertificate functie voor malware scan resultaten. Zie sectie 5.7 voor meer informatie. ExtraServices structuur toegevoegd aan de getSSLCertificateList functie voor malware scan resultaten. Zie sectie 5.8 voor meer informatie. Kleine tekstuele aanpassingen.

Versie 1.0.21 (27 oktober 2010) • •

•

• •

Integratie van de opties voor malware scan voor bepaalde SSL Certificaten. Zie sectie 8.4.1 voor meer informatie. extraPreferences functie toegevoegd aan het orderSSLCertificate proces om de opties voor het instellen van een malware scan tijdens het bestellen van een certificaat mogelijk te maken. Zie secties 5.3 en 8.4.1 voor meer informatie. Licentie veld toegevoegd aan de orderSSLCertificate functie voor licenties. Zie sectie 5.3 voor meer informatie. Deze optie is niet noodzakelijk voor certificaten welke een ongelimiteerde server licentie geldt, waarvoor standaard 1 geldt. Zie de product details in sectie 8.1 voor meer informatie. updateSSLCertificate functie toegevoegd voor het updaten van de malware scan opties en om een On-Deman-Scan aan te vragen. Zie sectie 5.10 voor meer informatie. BUG FIX: “paymentMethod” veld verwijderd van de orderSSLCertificate aanvraag. Het is niet langer noodzakelijk om de paymentMethod op te geven. Waar dit werd gevraagd kwam een bug. Nu verschijnt er een waarschuwing op het moment dat het veld wordt weergegeven bij de orderSSLCertificate functie.

Versie 1.0.20 (22 september 2010) •

Kleine tekstuele aanpassingen.

Versie 1.0.19 (19 augustus 2010) •

• • •

updateDomain functie toegevoegd, zie sectie 6.7 voor meer details. Met deze functie kunt u uw techHand en adminHandle van een domeinnaam updaten. Mits nodig wijzig eerst de contact persoon gegevens met de updateRelation functie. cancelDomain functie toegevoegd, zie sectie 6.8 voor meer details. Met deze functie kunt u uw domeinnaam opzeggen. Wees voorzichtig hiermee, uw domeinnaam word permanent verwijderd. Uitleg over het connecteren naar de API toegevoegd, zie sectie 2.2 voor meer informatie. Uitleg over het bestellen van een domeinnaam toegevoegd, zie sectie 2.4 voor meer informatie.

Versie 1.0.18 (1 april 2010) •

passportNumber veld toegevoegd aan alle relatie gerelateerde functies. Zie hoofdstuk 3 voor meer informatie.


pagina 9 van 99

• • • • •

getDomainList functie toegevoegd, zie sectie 6.6 voor meer details. Met deze functie kunt u een lijst opvragen van de lopende/aangevraagde domeinnamen. De functie getDomainOrder is DEPRECATED (verouderd), gebruik de nieuwe getDomain functie hiervoor in de plaats. Zie sectie 6.5. De functie getSSLCertificateOrder is DEPRECATED (verouderd), gebruik de nieuwe getSSLCertificate functie hiervoor in de plaats. Zie sectie 5.7. De functie getSSLCertificateOrderList is DEPRECATED (verouderd), gebruik de nieuwe getSSLCertificateList functie hiervoor in de plaats. Zie sectie 5.8. Elke response bevat nu een <warnings> structuur, gelijkwaardig aan de <errors> structuur. Deze kan 1 of meerdere waarschuwingen bevatten zoals een deprecated functie of veld. Een waarschuwing betekend niet dat uw request niet word uitgevoerd.

Versie 1.0.17 (1 maart 2010) •

authCode veld toegevoegd aan de getDomainOrder functie, zie sectie 6.4.2 voor meer informatie. Dit veld is alleen beschikbaar als er een authCode bekend is.


•

•

Veranderingen aangebracht aan de getSSLCertificateOrder (sectie 3.1.6, nu 5.5) en de getSSLCertificateOrderList (sectie 3.1.7, nu 5.6) functies. Het betreft het terugkrijgen van de company, contact, adminContact and techContact informatie. Het geeft nu alleen de handles in plaats van alle data. De data kan uiteraard worden ontvangen door de getRelation functie te gebruiken. getDomainOrder functie toegevoegd voor het nakijken van de orderstatus van de domeinnaam en het opvragen van domeinnaam informatie. Zie sectie 3.2.2 voor meer informatie en sectie 7.6.5 voor een code voorbeeld. Zie sectie 8.3.3 voor status codes u kunt terug verwachten. Verbeteringen aan de documentatie. Sectie 3 'Webservice details' is nu opgesplitst in meerdere hoofdstukken voor relation, product, SSL Certificates and domain om het zo eenvoudiger te maken om terug te vinden wat u nodig heeft.

Versie 1.0.15 (13 januari 2010) • • •

Spelfout “companyhandle” aangepast naar de juiste “companyHandle” in sectie 3.1.9 orderDomain. getSSLCertificateOrderList functie toegevoegd, zie sectie 3.1.7 voor meer details. Met deze functie kunt u een lijst opvragen van de lopende/aangevraagde SSL Certificaten. Aan getSSLCertificateOrder en getSSLCertificateOrderList zijn de secties adminContact en techContact toegevoegd.

Versie 1.0.14 (7 januari 2010) •

Toegevoegd availabilityCode and Message voor ongeldige TLD, zie sectie 5.3.2.

Versie 1.0.13 (22 december 2009) • • • • • •

checkDomain functie toegevoegd, zie sectie 3.1.9 voor meer details. Zie sectie 4.6.3 voor voorbeeld code. orderDomain functie toegevoegd, zie sectie 3.20 voor meer details. Zie sectie 4.6.4 voor voorbeeld code. nameServerChange functie toegevoegd, zie sectie 3.21 voor meer details. Zie sectie 4.6.5 voor voorbeeld code. Het betaalmethodeveld is verwijderd van de “orderSSLCertificate request”. Het is niet langer nodig om uw betaalmethode te specificeren. Zie sectie 3.14.1. De “accountNumber” en “accountType” zijn niet langer verplicht in het createRelation en UpdateRelation verzoek. Zie sectie 3.1.1 en 3.2.1. Sectie met ProductCodes voor Hosting toegevoegd, zie sectie 5.2.

Versie 1.0.12 (23 april 2009) •

Nieuw lay-out van document.


pagina 10 van 99

Versie 1.0.11 (16 april 2009) •

certificateType veld toegevoegd aan orderSSLCertificate functie om het bestellen van Code Signing Certicates mogelijk te maken.

Versie 1.0.10 (20 maart 2009) •

Nieuwe sectie toegevoegd over het API overzicht op onze website, zie sectie 6.

Versie 1.0.9 (9 maart 2009) •

Enkele tekstuele wijzigingen en aanpassingen in de inhoudsopgave.

Versie 1.0.8 (6 maart 2009) •

Aanpassingen in die veld definities lijst, zie sectie 4.4.

Versie 1.0.7 (3 maart 2009) •

Lijst met fout codes toegevoegd, zie sectie 4.3.2

Versie 1.0.6 (25 februari 2009) • • • •

Networking4all Trial Mobile, productCode 1651, toegevoegd. Nieuwe functie getSSLCertificateOrder toegevoegd, zie sectie 3.16 voor meer informatie. Lijst met SSL Certificaat status codes toegevoegd, zie sectie 5.2.1 Nieuwe sectie toegevoegd over UTF-8.


Voorbeeld code toegevoegd voor SAN Certifcaten, zie sectie 4.5.8, 4.5.9 en 4.5.10 voor meer informatie.

Versie 1.0.4 (20 februari 2009) • • •

ProductCode voor Networking4all Intranet certificaat aangepast naar 1121 ProductCode voor Networking4all Pro SAN certificaat aangepast naar 1648 SAN veld toegevoegd aan de checkSSLCertificateCSR functie.


Aanpassingen in alle code voorbeelden met betrekking tot UTF-8 encoding.

Versie 1.0.2 (11 februari 2009) • •

Veranderingen in de getProduct response. Veranderingen in de veld definities.


API url aangepast.


Eerste publieke versie voor test doeleinden en het afnemen van producten.


pagina 11 van 99

2 Principe van de API 2.1Basis werking De Networking4all Partner website doet een aanvraag via de API en de API komt terug met een respons. Deze respons bevat de aangevraagde informatie of bijvoorbeeld een relatie handle die is aangemaakt aan de hand van de aanvraag. De respons kan ook een foutcode bevatten, in dat geval is de aanvraag niet uitgevoerd.

Networking4all

resellers

2.2Connecteren naar de API

2.2.1Staging omgeving Voor belangrijke wijzigingen in onze API is er een staging omgeving opgezet. Dit geeft u de mogelijkheid om aanpassingen te maken voordat deze wijzigingen op de live omgeving komen. Connecteren naar de API word gedaan via een Simple Object Access Protocol (SOAP) client in WSDL mode. U connecteerd naar de volgende URL : http://www.stagingenvironment.com/api/soap/api.wsdl Belangrijk is het om te weten dat de variable test = 1 op de staging omgeving word genegeerd. 2.2.2Test en Live omgeving Connecteren naar de API word gedaan via een Simple Object Access Protocol (SOAP) client in WSDL mode. U connecteerd naar de volgende URL : https://www.networking4all.com/api/soap/api.wsdl Belangrijk is het om te weten dat als u test = 1 aanzet in uw request u connecteerd naar de testomgeving. Als dit word weggelaten of test = 0 connecteerd u ten alle tijden naar de live omgeving. Voorbeelden kunt uw vinden in bij de code voorbeelden in sectie 7.5 en 7.6.


pagina 12 van 99

2.3De bestelling van een SSL certificaat De bestelling van een SSL Certificaat verloopt via de volgende stappen. 1

2

Networking4all

3

resellers

4*

5

1. Maak eerst een bedrijfsnaam aan met de createRelation functie. De Api komt met een bedrijf handle respons (Optioneel) 2. Maak een contactpersoon aan met de createRelation functie. De Api komt met een contact handle respons (Optioneel) 3. Check de CSR met de checkSSLCertificateCSR functie, indien correct, ga verder. 4. Vraag de Approver Email lijst met getSSLCertificateApproverList. Notitie: voor sommige SSL certificaten is deze stap noodzakelijk. 5. Bestel het SSL Certificaat via de orderSSLCertificate functie, met de CSR en de gegevens van de handles, zie stap 1 en stap 2 ( of gebruik al bestaande handles) en het Approver Email adres indien noodzakelijk. Meer informatie over deze stappen staat in sectie 3 en 5 van dit document. In sectie 7 staan tevens code voorbeelden van het gehele proces.

Na het bestelproces wordt een factuur verzonden en indien noodzakelijk een Approver Email om de aanvraag te bevestigen c.q. Valideren. Indien u de aanvraag bevestigd krijgt u het certificaat via email, meestal binnen enkele minuten.

2.4De bestelling van een Domeinnaam De bestelling van een SSL Certificaat verloopt via de volgende stappen. 1


pagina 13 van 99

2

Networking4all

3

resellers

4*

5

1. Maak eerst een bedrijfsnaam aan met de createRelation functie. De Api komt met een bedrijf handle respons (Optioneel) 2. Maak een contactpersoon aan met de createRelation functie. De Api komt met een contact handle respons (Optioneel) 3. Check de beschikbaarheid van de domeinnaam met de checkDomain functie, indien beschikbaar of als deze domeinnaam van u is en u wilt verhuiizen, ga verder. 5. Bestel de domeinnaam via de orderDomain functie, met de gegevens van de handles, zie stap 1 en stap 2 ( of gebruik al bestaande handles) en het eventueel Name Servers indien noodzakelijk. Meer informatie over deze stappen staat in sectie 3 en 6 van dit document. In sectie 7 staan tevens code voorbeelden van het gehele proces.

Na het bestelproces wordt een factuur verzonden en indien noodzakelijk een Approver Email om de aanvraag te bevestigen c.q. Valideren. Indien u de aanvraag bevestigd krijgt u het certificaat via email, meestal binnen enkele minuten.


pagina 14 van 99

3 Web service details: Relaties De volgende XML notatie conventies worden gebuikt: ( ) moet worden gevolgd door een *, ? of + om de kardinaliteit aan te geven ? 0 of 1 * 0 of meer + 1 of meer

3.1createRelation De createRelation functie is bedoeld om bedrijfs- en contactrelaties aan te maken. Het is mogelijk tegelijkertijd een bedrijfsrelatie met de contactpersoon aan te maken, door de contact informatie in te vullen tijdens het creëren van de bedrijfsrelatie. Account informatie kunt u zelf specificeren bij het creëren van de contactpersoon, zo niet dan wordt er automatisch een gebruikersnaam en wachtwoord aangemaakt. Voor het specificeren van account informatie, dient de createAccount option = 1 aan te staan, anders wordt de account informatie die u heeft gespecificeerd genegeerd. In ons systeem is een contactpersoon altijd gekoppeld aan een bedrijf. Dit maakt het vinden van contacten in onze portal eenvoudiger. Wanneer u aan de hand van onze API een nieuw contact wilt maken dient u gebruik te maken van de handle van het bedrijf om het contact te koppelen. In de meeste gevallen zult u eerst een bedrijf moeten aanmaken. U krijgt de handle terug bij het creëren van een bedrijf. Dit kan vervolgens gebruikt worden bij het maken van een contactpersoon en om dit contact te koppelen aan het bedrijf. Dit is de beste manier om nieuwe contacten aan te maken. Wanneer u met een systeem werkt waarin het contact en bedrijf gekoppeld zijn kunt u de handle achterwege laten. Het contact zal NIET worden gekoppeld aan een specifiek bedrijf, maar aan uw reseller account. BELANGRIJK: Het is zeer belangrijk dat u de handles gebruikt welke u al aangemaakt heeft in plaats van het steeds opnieuw creëren van hetzelfde bedrijf of contact. Wanneer u dit wel doet kunnen er technische en financiële complicaties optreden. Bijvoorbeeld tijdens het bijwerken van uw domeinnamen met adminContact en techContact. Wanneer dit allemaal verschillende handles zijn zullen ze stuk voor stuk dienen te worden geüpdate in plaats van slechts één enkele of een paar handles. 3.1.1createRelation request <requestHeader> <username> <password> ()? ()? ()? <request> ()? ( <initials> <firstName> (<middleName>)? <lastName> (<gender>)? (<birthDate>)? (<passportNumber>)? </contact>)?  © 2013 Networking4all - www.networking4all.com pagina 15 van 99 (<company> <name> (<employees>)? (<chamberOfCommerce>)? </company>)?  (<address rel="nofollow"> <type>  <street>  <streetNumber>  (<streetNumberExtension>)?  (<buildingName>)? <street1> (<street2>)? (<street3>)? <postalCode> <city> <province> <countryCode> </address>)+ <phone>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </phone> (<fax>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </fax>)? (<mobile>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </mobile>)? <phoneNumber> (<faxNumber>)? (<mobileNumber>)? <email> (<website>)? (<account rel="nofollow"> <username> <password> <passwordConfirm> </account>)? (<financial> (<accountNumber rel="nofollow">)? (<accountType rel="nofollow">)? (<bicCode>)? (<ibanNumber>)? (<vatin>)? </financial>)? (<option> <createAccount> </option>)? </request> </createRelation> 3.1.2createRelation Response <createRelationResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> © 2013 Networking4all - www.networking4all.com pagina 16 van 99 <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> (<handle>)+ (<account rel="nofollow"> <username> <password> </account>)? </response>)?  </createRelationResponse> 3.2updateRelation De updateRelation functie stelt u in staat om bedrijfs- en contactinformatie aan te passen. Ook kunt u hiermee gebruikersnaam en wachtwoord wijzigen indien de optie account informatie is gespecificeerd. 3.2.1updateRelation request <updateRelation xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> (<type>)?  <handle>  (<contact> <title> <initials> <firstName> (<middleName>)? <lastName> (<gender>)? (<birthDate>)? (<passportNumber>)? </contact>)?  (<company> <name> (<employees>)? (<chamberOfCommerce>)? </company>)?  (<address rel="nofollow"> <type>  <street>  <streetNumber>  (<streetNumberExtension>)?  (<buildingName>)? <street1> (<street2>)? (<street3>)? <postalCode> <city> <province> <countryCode> </address>)+ <phone>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </phone> (<fax>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </fax>)? (<mobile>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </mobile>)? <email> (<website>)? (<account rel="nofollow"> <username> <password> <passwordConfirm> </account>)? (<financial> (<accountNumber rel="nofollow">? (<accountType rel="nofollow">)? (<bicCode>)? (<ibanNumber>)? (<vatin>)? </financial>)? (<option> <createAccount> </option>)? </request> </updateRelation> 3.2.2updateRelation Response <updateRelationResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> © 2013 Networking4all - www.networking4all.com pagina 18 van 99 (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <handle> (<account rel="nofollow"> <username> <password> </account>)? </response>)?  </updateRelationResponse> 3.3deleteRelation De deleteRelation functie stelt u in staat een relatie te verwijderen. 3.3.1deleteRelation Request <deleteRelation xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <handle>  </request> </deleteRelation> 3.3.2deleteRelation Response <deleteRelationResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <handle> </response>)? </deleteRelationResponse> 3.4getRelation Met de getRelation functie wordt de contact en bedrijfsinformatie weergegeven. © 2013 Networking4all - www.networking4all.com pagina 19 van 99 3.4.1getRelation Request <getRelation xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> (<handle>)?  <handle> (<clientNumber>)  (<reseller>)? (<resellerHandle>)?  (<companyHandle>)+  (<contact> <title> <initials> <firstName> (<middleName>)? <lastName> (<gender>)? (<birthDate>)? (<passportNumber>)? </contact>)? (<company> <name> (<employees>)? (<chamberOfCommerce>)? </company>)? © 2013 Networking4all - www.networking4all.com pagina 20 van 99 (<address rel="nofollow"> <type>  <street>  <streetNumber>  (<streetNumberExtension>)?  (<buildingName>)? <street1> (<street2>)? (<street3>)? <postalCode> <city> <province> <countryCode> </address>)+ <phone>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </phone> (<fax>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </fax>)? (<mobile>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </mobile>)? <phoneNumber> (<faxNumber>)? (<mobileNumber>)? <email> (<website>)? (<account rel="nofollow"> <username> </account>)? (<financial> <accountNumber rel="nofollow"> <accountType rel="nofollow"> (<bicCode>)? (<ibanNumber>)? (<vatin>)? </financial>)? <audit rel="nofollow"> <created> (<createdHandle>)? (<updated>)? (<updatedHandle>? </audit> <status>? </response>)?  </getRelationResponse> 3.5getRelationContacts Met de getRelationContacts functie wordt een lijst met contactpersonen weergegeven voor een gespecificeerd bedrijf. 3.5.1getRelationContacts Request <getRelationContacts xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  © 2013 Networking4all - www.networking4all.com pagina 21 van 99 <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <handle> </request> </getRelationContacts>  3.5.2getRelationContacts Response <getRelationContactsResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> (<item> <type>  (<handle>)?  (<clientNumber>)  (<reseller>)?  (<resellerHandle>)?  (<companyHandle>)+  (<contact> <title> <initials> <firstName> (<middleName>)? <lastName> (<gender>)? (<birthDate>)? (<passportNumber>)? </contact>)?  (<company> <name> (<employees>)? (<chamberOfCommerce>)? </company>)? (<address rel="nofollow"> <type>  © 2013 Networking4all - www.networking4all.com pagina 22 van 99 <street>  <streetNumber>  (<streetNumberExtension>)?  (<buildingName>)? <street1> (<street2>)? (<street3>)? <postalCode> <city> <province> <countryCode> </address>)+ <phone>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </phone> (<fax>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </fax>)? (<mobile>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </mobile>)? <phoneNumber> (<faxNumber>)? (<mobileNumber>)? <email> (<website>)? (<account rel="nofollow"> <username> </account>)? (<financial> <accountNumber rel="nofollow"> <accountType rel="nofollow"> (<bicCode>)? (<ibanNumber>)? (<vatin>)? </financial>)? <audit rel="nofollow"> <created> (<createdHandle>)? (<updated>)? (<updatedHandle>? </audit> <status>? </item>)+ </response>)?  </getRelationContactsResponse> 3.6addRelationContacts De addRelationContacts functie stelt u in staat om contacten toe te voegen aan een bepaald bedrijf. 3.6.1addRelationContacts Request <addRelationContacts xmlns=”https://www.networking4all.com/api/soap/api.wsdl” rel="nofollow"> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> © 2013 Networking4all - www.networking4all.com pagina 23 van 99 </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <handle> (<contacts>)+ </request> </addRelationContacts>  3.6.2addRelationContacts Response <addRelationContactsResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl” rel="nofollow"> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <handle> <result>  </response>)?  </addRelationContactsResponse> 3.7removeRelationContacts De removeRelationContacts functie stelt u in staat om contacten van een bepaald bedrijf te verwijderen. 3.7.1removeRelationContacts Request <removeRelationContacts xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <handle>  </request> </removeRelationContacts> © 2013 Networking4all - www.networking4all.com pagina 24 van 99 3.7.2removeRelationContacts Response <removeRelationContactsResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <handle> <result>  </response>)?  </removeRelationContactsResponse> 3.8getRelationResellerClients De getRelationResellerClients functie stelt u in staat om een lijst van Resellers te verkrijgen behorende bij een bepaald bedrijf. 3.8.1getRelationResellerClients Request <getRelationResellerClients xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <handle>  </request> </getRelationResellerClients> 3.8.2getRelationResellerClients Response <getRelationResellerClients Response xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> © 2013 Networking4all - www.networking4all.com pagina 25 van 99 </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> (<item> <type>  (<handle>)?  (<clientNumber>)  (<reseller>)?  (<resellerHandle>)?  (<companyHandle>)+  (<contact> <title> <initials> <firstName> (<middleName>)? <lastName> (<gender>)? (<birthDate>)? (<passportNumber>)? </contact>)?  (<company> <name> (<employees>)? (<chamberOfCommerce>)? </company>)? (<address rel="nofollow"> <type>  <street>  <streetNumber>  (<streetNumberExtension>)?  (<buildingName>)? <street1> (<street2>)? (<street3>)? <postalCode> <city> <province> <countryCode> </address>)+ <phone>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </phone> (<fax>  <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </fax>)? (<mobile>  <countryCode> <trunkCode> © 2013 Networking4all - www.networking4all.com pagina 26 van 99 <subscriberNumber> (<extension>)? </mobile>)? <phoneNumber> (<faxNumber>)? (<mobileNumber>)? <email> (<website>)? (<account rel="nofollow"> <username> </account>)? (<financial> <accountNumber rel="nofollow"> <accountType rel="nofollow"> (<bicCode>)? (<ibanNumber>)? (<vatin>)? </financial>)? <audit rel="nofollow"> <created> (<createdHandle>)? (<updated>)? (<updatedHandle>? </audit> <status>? </item>)+ </response>)?  </getRelationResellerClients> 3.9addRelationResellerClients De addRelationResellerClients functie stelt u in staat om bestaande resellers toe te voegen aan een bepaald bedrijf. 3.9.1addRelationResellerClients Request <addRelationContacts xmlns=”https://www.networking4all.com/api/soap/api.wsdl” rel="nofollow"> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <handle>  </request> </addRelationContacts> 3.9.2addRelationResellerClients Response <addRelationContactsResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl” rel="nofollow"> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> © 2013 Networking4all - www.networking4all.com pagina 27 van 99 (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <handle> <result>  </response>)?  </addRelationContactsResponse> 3.10removeRelationResellerClients De removeRelationResellerClients functie stelt u in staat om resellers te verwijderen bij een bepaald bedrijf. 3.10.1removeRelationResellerClients Request <removeRelationResellerClients xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <handle>  </request> </removeRelationResellerClients> 3.10.2removeRelationResellerClients Response <removeRelationResellerClientsResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> © 2013 Networking4all - www.networking4all.com pagina 28 van 99 <handle> <result>  </response>)?  </removeRelationResellerClientsResponse> © 2013 Networking4all - www.networking4all.com pagina 29 van 99 4 Web service details: Producten 4.1getProduct Met de getProduct functie kunt u door middel van de ProductCode informatie opvragen over dat betreffende product. 4.1.1getProduct Request <getProduct xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <productCode>  </request> </getProduct> 4.1.2getProduct Response <getProductResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <productCode> <name> <period> <description> <short> (<long>)? </description> <fees> <setup>  <retail> <actual rel="nofollow"> </setup> (<fee> <period> <retail> © 2013 Networking4all - www.networking4all.com pagina 30 van 99 <actual rel="nofollow"> <type> <currency> </fee>)+ </fees> (<vat>)? (<details> <mailValidation> <dv> <ov> <ev> <webserver> <company> <codesigning> <san> <wildcard> <intranet> <mobile> <competitiveUpgrade> (<details>)? </response>)? </getProductResponse> 4.2getProducts De getProduct functie geeft u de mogelijkheid om een lijst met productCodes en namen op te vragen. Deze lijst geeft u geen extra informatie zoals prijzen. Hiervoor dient u getProduct te gebruiken. 4.2.1getProducts Request <getProducts xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <type>  </request> </getProducts> 4.2.2getProducts Response <getProductsResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ © 2013 Networking4all - www.networking4all.com pagina 31 van 99 </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <products> (<product> <code> <name> (<brand>)?  </product>)+ </products> </response>)? </getProductsResponse> © 2013 Networking4all - www.networking4all.com pagina 32 van 99 5 Web service details: SSL Certificaten 5.1checkSSLCertificateCSR De checkSSLCertificateCSR functie stelt u in staat om uw CSR te checken. 5.1.1checkSSLCertificateCSR Request <checkSSLCertificateCSR xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <productCode>  <csr>  </checkSSLCertificateCSRResponse> © 2013 Networking4all - www.networking4all.com pagina 33 van 99 5.2getSSLCertificateApproverList Met de getSSLCertificateApproverList functie krijgt u een lijst met Approver Email adressen die nodig zijn voor het bestellen van Domain Validated (DV) SSL certificaten. 5.2.1getSSLCertificateApproverList Request <getSSLCertificateApproverList xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <productCode>  <domain>  </request> </getSSLCertificateApproverList> 5.2.2getSSLCertificateApproverList Response <getSSLCertificateApproverListResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> (<approvers rel="nofollow">)+ (<orderNumber)?  </response>)? </getSSLCertificateApproverListResponse> 5.3orderSSLCertificate Met de orderSSLCertificate functie kunt u een SSL certificaat bestellen. 5.3.1orderSSLCertificate Request <orderSSLCertificate xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> © 2013 Networking4all - www.networking4all.com pagina 34 van 99 <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <companyHandle> <adminHandle rel="nofollow"> <techHandle> <productCode> (<orderKind>)?  (<traceNumber>)?  <period>  <csr> (<licences>)?  (<approverEmail rel="nofollow">)?  (<san>)* (<reference)? (<orderNumber>)? (<certificateType)?  (<title>)?  (<organization>)?  </option>)? </request> </orderSSLCertificate> 5.3.2orderSSLCertificate Response <orderSSLCertificateResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <traceNumber>  © 2013 Networking4all - www.networking4all.com pagina 35 van 99 (<orderNumber>)?  (<fileContent>)?  </response>)? </orderSSLCertificateResponse> 5.4resendEmailSSLCertificate De resendEmailSSLCertificate functie stelt u in staat om de Approver Email opnieuw te sturen of deze te wijzigen. Het wijzigen van het approverEmail adress is niet voor alle producten mogelijk , zie section 5.1.1 voor meer informatie. Het opgegeven approverEmail wordt genegeerd voor producten waar dit niet mogelijk is. 5.4.1resendEmailSSLCertificate Request <resendEmailSSLCertificate xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <traceNumber>  (<approverEmail rel="nofollow">)?  </request> </resendEmailSSLCertificate> 5.4.2resendEmailSSLCertificate Response <resendEmailSSLCertificateResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <traceNumber> <orderNumber> (<approverEmail rel="nofollow">)? </response>)? </resendEmailSSLCertificateResponse> © 2013 Networking4all - www.networking4all.com pagina 36 van 99 5.5getSSLCertificateOrder De getSSLCertificateOrder functie stelt u in staat om de status van uw SSL order te controleren en indien de order gerealiseerd is (status 216) kunt u het SSL Certificaat via onze API ophalen. Deze functie is DEPRECATED (verouderd), gebruik getSSLCertificate hiervoor in de plaats, zie sectie 5.7. 5.6getSSLCertificateOrderList De getSSLCertificateOrderList functie stelt u in staat om een lijst op te halen met een of meerdere SSL Certificaat bestellingen en de status te controleren. U kunt verschillende filters opgeven zoals begin en eind datum, status en handle. Indien de order gerealiseerd is (status 216) kunt u het SSL Certificaat via onze API ophalen. Deze functie is DEPRECATED (verouderd), gebruik getSSLCertificate hiervoor in de plaats, zie sectie 5.8. 5.7getSSLCertificate De getSSLCertificate functie stelt u in staat om de status van uw SSL bestelling te controleren en indien de gerealiseerd is (status 216) kunt u het SSL Certificaat via onze API ophalen. 5.7.1getSSLCertificate Request <getSSLCertificate xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <traceNumber>  (<comment>)?  </substatus>)+ </substatusses>)? </status> <domain> (<sanNames> (<san>)+ </sanNames>)? (<certificateType>)?  (<commonName>)?  (<title>)?  (<organization>)?  <retail> <actual rel="nofollow"> </setup> (<fee> <period> <retail> <actual rel="nofollow"> <type> <currency> </fee>)+ </fees> (<vat>)? (<details> <mailValidation> <dv> <ov> <ev> <webserver> <company> <codesigning> © 2013 Networking4all - www.networking4all.com pagina 38 van 99 <san> <wildcard> <intranet> <mobile> <competitiveUpgrade> (<details>)? (<total>)? </product>)+ (<total>)? </products> <period> <startDate> <expDate> (<reference>)? (<paymentMethod>)? <company> <contact> <adminContact rel="nofollow"> <techContact> <fulfillment>  <certificate> (<caCertificates> (<caCertificate> (<type>)? (<name>)? <certificate> </caCertificate>)+ </caCertificates>)? </fulfillment> (<extraServices> (<extraPreferences>)? (<extraServicesResults> (<lastScanDate>)? (<sealStatus>)? (<scanStatus>)? (<resultsFound>)? (<scanResults> (<infection>) <type> <date> <url> (<description>)? </infection>)+ </scanResults>)? </extraServicesResults>)? </extraServices>)? </response>)? </getSSLCertificateResponse> 5.8getSSLCertificateList De getSSLCertificateList functie stelt u in staat om een lijst op te halen met een of meerdere SSL Certificaat bestellingen en de status te controleren. U kunt verschillende filters opgeven zoals begin en eind datum, status en handle. Indien de bestelling gerealiseerd is (status 216) kunt u het SSL Certificaat via onze API ophalen. 5.8.1getSSLCertificateList Request <getSSLCertificateList xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? © 2013 Networking4all - www.networking4all.com pagina 39 van 99 (<test>)? </requestHeader> (<request> (<fromDate>)? (<toDate>)? (<fromExpDate>)? (<toExpDate>)? (<status>)? (<handle>)? </request>)? </getSSLCertificateList> 5.8.2getSSLCertificateList Response <getSSLCertificateListResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> (<fromDate>)? (<toDate>)? (<fromExpDate>)? (<toExpDate>)? (<status>)? (<handle>)? (<result> <traceNumber> <Number> <status> <code> (<message>)? (<substatusses> (<substatus> <code> <name> <startDate> (<endDate>)?  (<comment>)?  </substatus>)+ </substatusses>)? </status> <domain> (<sanNames> (<san>)+ </sanNames>)? (<certificateType>)?  (<commonName>)?  © 2013 Networking4all - www.networking4all.com pagina 40 van 99 (<title>)?  (<organization>)?  <retail> <actual rel="nofollow"> </setup> (<fee> <period> <retail> <actual rel="nofollow"> <type> <currency> </fee>)+ </fees> (<vat>)? (<details> <mailValidation> <dv> <ov> <ev> <webserver> <company> <codesigning> <san> <wildcard> <intranet> <mobile> <competitiveUpgrade> (<details>)? (<total>)? </product>)+ (<total>)? </products> <period> <startDate> <expDate> (<reference>)? (<paymentMethod>)? <company> <contact> <adminContact rel="nofollow"> <techContact> (<fulfillment>  <certificate> (<caCertificates> (<caCertificate> (<type>)? (<name>)? <certificate> </caCertificate>)+ </caCertificates>)? </fulfillment>)? (<extraServices> (<extraPreferences>)? © 2013 Networking4all - www.networking4all.com pagina 41 van 99 </get (<extraServicesResults> (<lastScanDate>)? (<sealStatus>)? (<scanStatus>)? (<resultsFound>)? (<scanResults> (<infection>) <type> <date> <url> (<description>)? </infection>)+ </scanResults>)? </extraServicesResults>)? </extraServices>)? </result>)+ </response>)? </getSSLCertificateListResponse> 5.9replaceSSLCertificate Met de replaceSSLCertificate functie kunt u een SSL certificaat vervangen. 5.9.1replaceSSLCertificate Request <replaceSSLCertificate xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <traceNumber>  <csr> <approverEmail rel="nofollow"> </request> </replaceSSLCertificate> 5.9.2replaceSSLCertificate Response <replaceSSLCertificateResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? © 2013 Networking4all - www.networking4all.com pagina 42 van 99 (<reference>)? (<test>)? </responseHeader> (<response> <traceNumber> <orderNumber> </response>)? </replaceSSLCertificateResponse> 5.10updateSSLCertificate De updateSSLCertificate functie stelt u in staat uw certificaat te updaten. Momenteel alleen gebruikt voor het wijzigen van Malware scan opties en aanvragen On-Demand-Scan. Mogelijk in de toekomst meerdere functionaliteiten. 5.10.1updateSSLCertificate Request <updateSSLCertificate xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <traceNumber>  <action rel="nofollow"> (<extraPreferences>)*  </request> </updateSSLCertificate> 5.10.2updateSSLCertificate Response <updateSSLCertificateResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <traceNumber> <orderNumber> </response>)? </updateSSLCertificateResponse> © 2013 Networking4all - www.networking4all.com pagina 43 van 99 5.11changeSANSSLCertificate De changeSANSSLCertificate functie stelt u in staat om SAN namen toe te voegen aan uw certificaat. Het is belangrijk dat u alle SAN namen die u wilt behouden plus de nieuwe SAN namen opgeeft aan deze functie. 5.11.1changeSANSSLCertificate request <changeSANSSLCertificate xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <traceNumber>  (<san>)*  </request> </changeSANSSLCertificate> 5.11.2changeSANSSLCertificate <changeSANSSLCertificateResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <traceNumber> <orderNumber> </response>)? </changeSSLCertificateResponse> © 2013 Networking4all - www.networking4all.com pagina 44 van 99 6 Web service details: Domeinnamen 6.1checkDomain Met de checkDomain functie kunt u één of meerdere domeinen controleren. Zie sectie 5.3.2 voor status codes welke u kunt verwachten in de checkDomain response. 6.1.1checkDomain Request <checkDomain xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> (<domain>)+ </request> </checkDomain> 6.1.2checkDomain Response <checkDomainResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> (<result> <domain> <availabilityCode rel="nofollow"> <availabilityMessage rel="nofollow"> </result>)+ </response>)? </checkDomainResponse> © 2013 Networking4all - www.networking4all.com pagina 45 van 99 6.2orderDomain Met de orderDomain functie kunt u een domeinnaam registreren. 6.2.1orderDomain Request <orderDomain xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <companyHandle> <adminHandle rel="nofollow"> <techHandle> <action rel="nofollow">  <domain> (<nameServers> <ns> (<ipv4>)? (<ipv6>)? </nameServers>)* (<authCode rel="nofollow">)? (<productCode>)?  </orderDomainResponse> 6.3nameServerChange Met de nameServerChange functie kunt u uw name server configuratie aanpassen. 6.3.1nameServerChange Request <nameServerChange xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <domain> (<nameServers> <ns> (<ipv4>)? (<ipv6>)? </nameServers>)+ </request> </nameServerChange> 6.3.2nameServerChange Response <nameServerChangeResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <domain> </response>)? </nameServerChangeResponse> © 2013 Networking4all - www.networking4all.com pagina 47 van 99 6.4getDomainOrder De getDomainOrder functie geeft u de mogelijkheid om de status en de bijbehorende informatie van uw domeinnaam order in te zien. U kunt zowel het uitgegeven traceNumber als de aangevraagde domeinnaam gebruiken. Deze functie is DEPRECATED (verouderd), gebruik getDomain hiervoor in de plaats, zie sectie 6.5. 6.5getDomain De getDomain functie geeft u de mogelijkheid om de status en de bijbehorende informatie van uw domeinnaam in te zien. U kunt zowel het uitgegeven traceNumber als de aangevraagde domeinnaam gebruiken. 6.5.1getDomain Request <getDomain xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> (<traceNumber>)?  (<domain>)?  </request> </getDomain> 6.5.2getDomain Response <getDomainResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <traceNumber> <domain> <status> <code> © 2013 Networking4all - www.networking4all.com pagina 48 van 99 (<message>)? </status> <serial> <refresh> <retry> <expire> <ttl> <hostmaster> <regDate> <startDate> <expDate> (<nameServers> <ns> (<ipv4>) (<ipv6>) </nameServers>)+ <company> <adminContact rel="nofollow"> <techContact> (<authCode rel="nofollow">)? (<reference>)? (<paymentMethod>)? </response>)? </getDomainResponse> 6.6getDomainList De getDomainList functie stelt u in staat om een lijst op te halen met een of meerdere domeinnaam bestellingen en de status te controleren. 6.6.1getDomainList Request <getDomainList xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> (<request> (<fromDate>)? (<toDate>)? (<fromExpDate>)? (<toExpDate>)? (<status>)? (<handle>)? </request>)? </getDomainList> 6.6.2getDomainList Response <getDomainListResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> © 2013 Networking4all - www.networking4all.com pagina 49 van 99 (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> (<fromDate>)? (<toDate>)? (<fromExpDate>)? (<toExpDate>)? (<status>)? (<handle>)? (<result> <traceNumber> <domain> <status> <code> (<message>)? </status> <serial> <refresh> <retry> <expire> <ttl> <hostmaster> <regDate> <startDate> <expDate> (<nameServers> <ns> (<ipv4>) (<ipv6>) </nameServers>)+ <company> <adminContact rel="nofollow"> <techContact> (<authCode rel="nofollow">)? (<reference>)? (<paymentMethod>)? </result>)+ </response>)? </getDomainListResponse> 6.7updateDomain De updateDomain functie geeft u de mogelijkheid het administratief contact en technisch contactpersoon te wijzigen. U kunt zowel het uitgegeven traceNumber als de aangevraagde domeinnaam gebruiken. 6.7.1updateDomain Request <updateDomain xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? © 2013 Networking4all - www.networking4all.com pagina 50 van 99 </requestHeader> <request> (<traceNumber>)? (<domain>)? <adminHandle rel="nofollow"> <techHandle> (<status>)? </request> </updateDomain>   6.7.2updateDomain Response <updateDomainResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <traceNumber> <domain> </response>)? </updateDomainResponse> 6.8cancelDomain De cancelDomain functie geeft u de mogelijkheid om de domeinnaam op te zeggen. U kunt zowel het uitgegeven traceNumber als de aangevraagde domeinnaam gebruiken. 6.8.1cancelDomain Request <cancelDomain xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> (<traceNumber>)?  (<domain>)?  </request> </cancelDomain> © 2013 Networking4all - www.networking4all.com pagina 51 van 99 6.8.2cancelDomain Response <cancelDomainResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <traceNumber> <domain> </response>)? </cancelDomainResponse> 6.9getDnsRecords De getDnsRecords functie geeft u de mogelijkheid om de DNS records van een domein op te halen. 6.9.1 getDnsRecords Request <getDnsRecords xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> (<domain>)  </request> </getDnsRecords> 6.9.2 getDnsRecords Response <getDnsRecordsResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ © 2013 Networking4all - www.networking4all.com pagina 52 van 99 </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <dnsrecords> (<dnsrecord> <name> <ttl> <type> <value> </dnsrecord>)+ </dnsrecords> </response>)?  </getDnsRecordsResponse> 6.10addDnsRecords De addDnsRecords functie geeft u de mogelijkheid om DNS records aan een domein toe te voegen. 6.10.1 addDnsRecords Request <addDnsRecords xmlns=”https://www.networking4all.com/api/soap/api.wsdl” rel="nofollow"> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <domain>  </addDnsRecordsResponse> 6.11updateDnsRecords De updateDnsRecords functie geeft u de mogelijkheid om DNS records te updaten. Hiervoor dienen zowel het oude record als het nieuwe record meegegeven te worden. 6.11.1 updateDnsRecords Request <updateDnsRecords xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <dnsrecords> (<dnsrecord> <old> <name> <ttl> <type> <value> </old> <new> <name> <ttl> <type> <value> </new> </dnsrecord>)+ </dnsrecords> </request> </updateDnsRecords> 6.11.2 updateDnsRecords Response <updateDnsRecordsResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> © 2013 Networking4all - www.networking4all.com pagina 54 van 99 <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <domain> </response>)?  </updateDnsRecordsResponse> 6.12deleteDnsRecords De deleteDnsRecords functie geeft u de mogelijkheid om de DNS records van een domein te verwijderen. 6.12.1 deleteDnsRecords Request <deleteDnsRecords xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <requestHeader> <auth rel="nofollow"> <handle>  <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader> <request> <domain>  <dnsrecords> (<dnsrecord> <name> <ttl> <type> <value> </dnsrecord>)+ </dnsrecords> </request> </deleteDnsRecords> 6.12.2 deleteDnsRecords Response <deleteDnsRecordsResponse xmlns=”https://www.networking4all.com/api/soap/api.wsdl”> <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> © 2013 Networking4all - www.networking4all.com pagina 55 van 99 <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> (<response> <domain> </response>)?  7.2De requestHeader Elke aanvraag dient een requestHeader te bevatten in onderstaand format; <requestHeader> <auth rel="nofollow"> <handle> <username> <password> </auth> (<language>)? (<reference>)? (<test>)? </requestHeader>  De <auth rel="nofollow"> structuur moet de login, gebruikersnaam en wachtwoord bevatten om de API te gebruiken. Optioneel kan een taal gespecificeerd worden waarin de foutmeldingen zullen worden getoond. Zonder specifieke taal aanduiding wordt hiervoor Engels gebruikt. Ook optioneel is een reference string die gebruikt kan worden als eigen referentie bij elke aanvraag. Belangrijk: Als u gebruik wilt maken van de testomgeving om te testen moet u de optionele <test> waarde meegeven met de waarde 1. Als deze waarde 0 is of dit veld wordt weggelaten wordt uw request uitgevoerd op de productie omgeving. 7.3De responseHeader De Networking4all API komt altijd terug met een responseHeader die er als volgt uitziet: <responseHeader> <resultCode> (<resultMessage>)? (<warnings> (<warning> <code> <message> <field> </warning>)+ </warnings>)? (<errors> (<error> <code> <message> <field> </error>)+ </errors>)? <timestamp> (<language>)? (<reference>)? (<test>)? </responseHeader> © 2013 Networking4all - www.networking4all.com pagina 57 van 99 7.3.1Resultaat codes De resultCode en resultMessage geven de status van het proces weer en kunnen de volgende waarden bevatten. Resultaat code Omschrijving 0 De opdracht is geslaagd. 1 De opdracht is geslaagd, er zijn geen resultaten gevonden. 2 De opdracht kon niet worden uitgevoerd, er zijn fouten, zie de error structuur. 3 De API is momenteel in onderhoudsmodus. 7.3.2Waarschuwing codes De <warning structuur heeft dezelfde structuur als de <error> structuur. Een lijst met mogelijke warnings. Deze lijst zou in de toekomst nog uitgebreid gaan worden. Waarschuwing code Omschrijving 1000 Functie is verouderd 1001 Veld is verouderd 7.3.3Fout codes De <error> structuur kan de volgende informatie bevatten. •<code> •<message> •<field> - Een numerieke fout code ter indicatie van het type. Een meer gedetailleerde foutmelding, in de opgegeven eigen taal. Het veld waarin de fout is opgetreden. Een lijst met alle mogelijke fout codes. Fout code Omschrijving 101 Waarde is leeg 102 Waarde is niet alfanumeriek 103 Geen alfabetisch teken 104 Niet binnen het bereik 105 Niet strikt binnen het bereik 106 Waarde is niet numeriek 107 Waarde is geen float type 108 Niet groter dan 109 Waarde is niet hexadecimaal 110 Token ontbreekt 111 Waardes zijn niet gelijk 112 Niet in array 113 Waarde is geen integer 114 Niet een IP adres 115 Niet kleiner dan © 2013 Networking4all - www.networking4all.com pagina 58 van 99 116 Waarde is een lege string 1001 Parameter ontbreekt 1002 Waarde is niet geldig 1003 Waarde is te kort 1004 Waarde is te lang 1005 Waarde bestaat niet (voorbeeld: een productCode die niet bestaat) 1006 Waarde bestaat al 2001 Email validatie fout 2002 Hostname validatie fout 2003 Gebruikersnaam validatie fout 2004 Wachtwoord sterkte fout 2005 Credit card validatie fout 3001 SSL Certificaat fout 3002 NameServer fout 3003 Domeinnaam fout 4001 Login fout 5001 Onbekende fout 7.4Veld definities Alle API aanvragen en respons velden in alfabetische volgorde: Veld Beschrijving Type <account rel="nofollow"> <username> <password> <passwordConfirm> </account> Account structuur. <accountNumber rel="nofollow"> Bankrekening nummer. string <accountType rel="nofollow"> Bank type, “GIRO”, “BANK” of “IBAN” string <actual rel="nofollow"> Actuele prijs, inclusief eventuele kortingen string <action rel="nofollow"> Domein actie, “register” of “transfer” string <action rel="nofollow"> updateSSLCertificate String handeling. Op het moment zijn twee opties beschikbaar, meer volgen mogelijk. UPDATE_EXTRA_PREFERE NCES en REQUEST_ON_DEMAND_S CAN Min Max Beide voor malware scan. <address rel="nofollow"> <type> <street> <streetNumber> © 2013 Networking4all - www.networking4all.com Adres structuur. Gebruik street1 in plaats van street, streetNumber en streetNumberExtension pagina 59 van 99 (<streetNumberExtension>? <street1> (<street2>)? (<street3>)? (<buildingName>)? <postalCode> <city> <province> <countryCode> </address> <adminHandle rel="nofollow"> Admin contact handle. string <approverEmail rel="nofollow"> Approver email voor SSL Certificaat. string <approvers rel="nofollow"> Approver email respons. string <audit rel="nofollow"> <created> (<createdHandle>)? (<updated>)? (<updatedHandle>? </audit> Audit informatie structuur respons op getRelation. <auth rel="nofollow"> Authentificatie structuur als onderdeel van requestHeader. <handle> <username> <password> </auth> <authCode rel="nofollow"> Authcode voor Domain transfer string <availabilityCode rel="nofollow"> Beschikbaarheid van een domain integer <availabilityMessage rel="nofollow"> Beschikbaarheid van een domain string <bicCode> BIC code. string <birthDate> Geboortedatum in JJJJ-MMDD format. string <buildingName> Gebouw aanduiding, naam. string <caCertificates> (<caCertificate> (<type>)? (<name>)? <certificate> </caCertificate>)+ </caCertificates> Structuur bevat de ROOT en/of INTERMEDIATE certificates. <chamberOfCommerce> Nummer KvK. string <certificate> Bevat SSL Certificaat string <certificateType> Alleen voor Code Signing Certificates. Toegestane types: ADOBE_AIR, APPLE (alleen thawte), JAVASOFT, MS_AUTHENTICODE, VBA string <city> Plaats. string <clients> Reseller client handles. string <clientNumber> Client nummer. string <cn> Common Name. string <company> <name> (<employees>)? © 2013 Networking4all - www.networking4all.com 10 3 255 3 255 10 Bedrijf structuur. pagina 60 van 99 (<chamberOfCommerce>)? </company> <companyHandle> Bedrijf handle. <contact> <title> <initials> <firstName> (<middleName>)? <lastName> (<gender>)? (<birthDate>)? </contact> Contact structuur. <contacts> string 10 Contact handle. string 10 <country> Country for GlobalSign PersonalSign/CodeSigning string 2 <countryCode> Land code , ISO 3166-2 standaard. string 2 <countryCode> Land code als onderdeel van tel/fax/mobiel nummer. integer 3 <createAccount> Optie voor het aanmaken van integer account informatie 0 of 1. <created> Datum in JJJJ-MM-DD format. string <createdHandle> Contact handle. string <csr> Geldig CSR, inclusief de begin en eind regels. string <description> <short> (<long>)? </description> Product beschrijving structuur. <details> <mailValidation> <dv> <ov> <ev> <webserver> <company> <codesigning> <san> <wildcard> <intranet> <mobile> <competitiveUpgrade> (<details> 10 Detail structuur voor een SSL certificate product. <domain> Geldige FQDN. string <email> Email adres. string <employees> Aantal werknemers. Integer <extension> Extensie als onderdeel van een tel/fax/mobiel nummer. Integer <extraPreferences> Extra voorkeuren voor malware scans (en andere instellingen in de toekomst). Mogelijke waarden: string - MS_ENABLED - MS_SIS_DISABLED © 2013 Networking4all - www.networking4all.com pagina 61 van 99 - MS_DISABLED <extraServices> (<extraPreferences> (<extraServicesResults> (<lastScanDate>)? (<sealStatus>)? (<scanStatus>)? (<resultsFound>)? (<scanResults> (<infection>) <type> <date> <url> (<description>)? </infection>)+ </scanResults>)? </extraServicesResults>) ? </extraServices> <fee> <period> <retail> <actual rel="nofollow"> <type> <currency> ExtraServices structuur voor extra services zoals malware. Fee structuur, bevat periode in maanden, onze prijs en de prijs incl, eventuele kortingen. </fee> <fees> <setup> <retail> <actual rel="nofollow"> </setup> (<fee> <period> <retail> <actual rel="nofollow"> <type> <currency> </fee>)+ </fees> <fax> <countryCode> <trunkCode> <subscriberNumber> (<extension>)? Fees structuur. Fax nummer structuur. DEPRECATED </fax> <faxNumber> Fax nummer string <firstName> Contact voornaam. string <financial> <accountNumber rel="nofollow"> <accountType rel="nofollow"> (<bicCode>)? (<ibanNumber>)? (<vatin>)? </financial> Structuur financiële informatie. <fulfillment> <certificate> (<caCertificates> (<caCertificate> (<type>)? (<name>)? <certificate> </caCertificate>)+ </caCertificates>)? </fulfillment> Fulfillment structuur, onderdeel van de getSSLCertificate functie. © 2013 Networking4all - www.networking4all.com 2 20 pagina 62 van 99 <gender> Geslacht. “M” or “W” string 1 <handle> Relatie handle. string 10 <ibanNumber> IBAN nummer. string <infection> <type> <date> <url> (<description>)? </infection> Infection structuur <initials> Initialen. string <ipv4> IP V4 adres string <ipv6> IP V6 adres (niet gebruikt) string <lastName> Contact achternaam. string <lastScanDate> Datum laatste malware scan string <language> Taal code. string <licences> Server licenties, optioneel voor sommige certificaten. integer <locality> Locality voor GlobalSign PersonalSign/CodeSigning string <long> Uitgebreide beschrijving. string <scanStatus> Status van de malware scan. De volgende waarden zijn mogelijk: string 2 20 2 – PASSED - FAILED - PENDING - UNREACHABLE - UNAVAILABLE <middleName> Contact tussenvoegsel. <mobile> <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </mobile> Structuur mobiel nummer. DEPRECATED <mobileNumber> Mobiel nummer string <name> Bedrijfsnaam. string <nameServers> <ns> (<ipv4>)? (<ipv6>)? </nameServers> NameServer structuur <ns> NamServer <option> <createAccount> </option> Structuur optie/optioneel. <orderNumber> Order nummer van CA. string <organisation> Organisatie naam. string <organisationUnit> Organisatie Unit (afdeling) string <passportNumber> Pasport nummer string © 2013 Networking4all - www.networking4all.com string 2 20 string pagina 63 van 99 <password> Wachtwoord. string 8 8 <passwordConfirm> Wachtwoord bevestiging string 8 8 <paymentMethod> Betaalmethode. string <period> Periode in jaren. integer <period> Periode in maanden (zoals teruggegeven in de fee structure) integer <phone> <countryCode> <trunkCode> <subscriberNumber> (<extension>)? </phone> Structuur telefoon nummer. DEPRECATED <phoneNumber> Telefoonnummer string <postalCode> Postcode string <products> (<product> <productCode> <name> <period> <description> <short> (<long>)? </description> <fees> <setup> <retail> <actual rel="nofollow"> </setup> (<fee> <period> <retail> <actual rel="nofollow"> </fee>)+ </fees> (<vat>)? (<total>)? </product>)+ (<total>)? </products> Product structuur, onderdeel getSSLCertificate funtie. <products> (<product> <code> <name> (<brand>)? <!-For SSL only --> </product>)+ </products> Products structure for getProducts <productCode> Product code string <province> Provincie. string <reference> Referentie. string <reseller> Response Y in geval van reseller string <resellerHandle> Handle van de reseller. string <result> Aantal resultaten. integer <resultsFound> Aantal malware infecties integer <retail> Prijs zonder kortingen string © 2013 Networking4all - www.networking4all.com 10 pagina 64 van 99 <san> FQDN SAN. (<sanNames> (<san>)+ </sanNames>)? SAN Namen structuur <sealStatus> Status van de seal. De volgende waarden zijn mogelijk: string string - SECURE_SEAL - TRUST_SEAL - OFF <setup> <retail> <actual rel="nofollow"> </setup> Setup structure. <short> Korte beschrijving. string <status> Status van contact. integer <status> <code> (<message>)? (<substatusses> (<substatus> <code> <name> <startDate> (<endDate>)?  (<comment>)?  </substatus>)+ </substatusses>)? </status> Status structure for getSSLCertificate and SSLCertificateList <stateOrProvince> Staat of Provincie voor GlobalSign PersonalSign/CodeSigning string <street> Straat. DEPRECATED string <streetNumber> Straat nummer. DEPRECATED integer <streetNumberExtension> Straat nummer toevoeging. DEPRECATED string <street1> Voledige adres string <street2> Optioneel string <street3> Optioneel string <subscriberNumber> Abonneenummer van tel/fax/mobiel nummer. integer 10 <techHandle> Technical contact handle. string 10 <test> Test of productie omgeving (1 = test ), Optioneel. integer <title> Contact title, b.v. Mw, Dhr etc. string <traceNumber> Traceer nummer benodig om een SSL certificaat te vervangen of de Email Approver te wijzigen. string <trunkCode> Netnummer van een tel/fax/mobiel nummer. integer © 2013 Networking4all - www.networking4all.com 3 255 10 pagina 65 van 99 <type> Relatie type, “contact” of “company”. <type> Structuur van adres gedeelte, string bv “visit” of “post”. <type> Type prijs in de getProduct, kan bevatten: string string setup new registration transfer trade restore renew <updated> Datum in JJJJ-MM-DD format. string <updatedHandle> Contact handle. string <username> Gebruikersnaam. string <vat> Percentage van VAT. (BTW) integer <vatin> VAT (BTW) nummer. string <website> Website URL. string 10 4 8 7.5Code voorbeelden SSL Certificaten Hier volgen een paar code voorbeelden (PHP). Deze voorbeelden laten de stappen zien die nodig zijn voor het bestellen van een SSL certificaat. We gaan hier uit van een Networking4all Basic SSL Certificaat, productcode 1630, voor de periode van 1 jaar. 7.5.1Bedrijf aanmaken Voor dit voorbeeld maken we eerst een nieuw bedrijf aan. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['type'] = utf8_encode('company'); /* © 2013 Networking4all - www.networking4all.com pagina 66 van 99 * Company information */ $params['request']['company']['name'] = utf8_encode('Test company'); $params['request']['company']['employees'] = 2; $params['request']['company']['chamberOfCommerce'] = ''; /* * Address information */ $address = array(); $address['type'] = utf8_encode('visit'); $address['street1'] = utf8_encode('Testlaan 562'); $address['postalCode'] = utf8_encode('0000 EN'); $address['city'] = utf8_encode('Den Haag'); $address['province'] = utf8_encode('Zuid Holland'); $address['countryCode'] = utf8_encode('NL'); $params['request']['address'][] = $address; /* * Address information (optional) */ $address = array(); $address['type'] = utf8_encode('post'); $address['street1'] = utf8_encode('Postbus 00000'); $address['postalCode'] = utf8_encode('0000 EN'); $address['city'] = utf8_encode('Amsterdam'); $address['province'] = utf8_encode('Noord Holland'); $address['countryCode'] = utf8_encode('NL'); $params['request']['address'][] = $address; /* * Phone number */ $params['request']['phoneNumber'] = '31207000000'; /* * Fax number */ $params['request']['faxNumber'] = '31207000000'; /* * Mobile number */ $params['request']['mobileNumber'] = '316001000000'; /* * Digital contact information */ $params['request']['email'] = utf8_encode('info@testcompany.com'); $params['request']['website'] = ''; /* * Back financial information */ $params['request']['financial']['accountNumber'] = '0000000'; $params['request']['financial']['accountType'] = utf8_encode('GIRO'); $params['request']['financial']['bicCode'] = ''; $params['request']['financial']['ibanNumber'] = ''; $params['request']['financial']['vatin'] = ''; $response = $client->createRelation($params); ?> Als deze aanvraag is uitgevoerd komt er een respons met de handle: TST-000001 (indicatief voor dit voorbeeld) © 2013 Networking4all - www.networking4all.com pagina 67 van 99 7.5.2Contact aanmaken Als voorbeeld maken we hier 1 contact aan voor bovengenoemd bedrijf. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['type'] = utf8_encode('contact'); /* * Handle to link this contact to company */ $params['request']['handle'] = utf8_encode('TST-000001'); /* * Contact */ $params['request']['contact']['title'] = utf8_encode('Dhr'); $params['request']['contact']['initials'] = utf8_encode('D'); $params['request']['contact']['firstName'] = utf8_encode('David'); $params['request']['contact']['middleName'] = ''; $params['request']['contact']['lastName'] = utf8_encode('Test'); $params['request']['contact']['gender'] = utf8_encode('M'); $params['request']['contact']['birthDate'] = utf8_encode('1981-01-01'); /* * Address information */ $address = array(); $address['type'] = utf8_encode('visit'); $address['street1'] = utf8_encode('Testlaan'0 562); $address['postalCode'] = utf8_encode('0000 EN'); $address['city'] = utf8_encode('Den Haag'); $address['province'] = utf8_encode('Zuid Holland'); $address['countryCode'] = utf8_encode('NL'); $params['request']['address'][] = $address; /* * Phone number */ $params['request']['phoneNumber'] = '31207000000'; /* * Fax number */ $params['request']['faxNumber'] = '31207000000'; /* © 2013 Networking4all - www.networking4all.com pagina 68 van 99 * Mobile number */ $params['request']['mobileNumber'] = '316001000000'; /* * Digital contact information */ $params['request']['email'] = utf8_encode('david@yourdomain.com'); $params['request']['website'] = ''; /* * Login account */ $params['request']['account']['username'] = utf8_encode('daid81'); $params['request']['account']['password'] = utf8_encode('paS$wd81'); $params['request']['account']['passwordConfirm'] = utf8_encode('paS$wd81'); /* * Options */ $params['request']['option']['createAccount'] = 1; $response = $client->createRelation($params); ?> Als deze aanvraag is uitgevoerd komt de respons met een handle : TST-000002 ( als voorbeeld ) 7.5.3Check de CSR We hebben nu de bedrijf en contact handle die nodig zijn voor het bestellen van een SSL certificaat, maar eerst moeten we nog de CSR controleren. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $csr = "-----BEGIN CERTIFICATE REQUEST----MIIB5jCCAU8CAQAwgaUxCzAJBgNVBAYTAk5MMRYwFAYDVQQIEw1Ob29yZCBCcmFi YW50MRMwEQYDVQQHEwpSb29zZW5kYWFsMRwwGgYDVQQKExNOZXR3b3JraW5nNGFs bCBCLlYuMR8wHQYDVQQDExZ3d3cubmV0d29ya2luZzRhbGwuY29tMSowKAYJKoZI hvcNAQkBFhtzZWN1cml0eUBuZXR3b3JraW5nNGFsbC5jb20wgZ8wDQYJKoZIhvcN AQEBBQADgY0AMIGJAoGBAOsi6VgMka2KLata8fn0zeXbwbmjcTKd6V973Jrm4mCk PAjFklWyGdXirtHV+Etbuiu7/WAEgwCVJK46tjMK+ZPpmt1f/kXxIUgjtZTaTS+r Cfzoyl85MZSKXNhIMOICvkn7m4YXyQDMXLearR+XVa2pnJ0MwpEnAeh8YEsps/Pp AgMBAAGgADANBgkqhkiG9w0BAQQFAAOBgQC3lC2dW6smhPD3SFXY0ypw9f7xnieL cosYjN0O/yos9NlflGsV0LuZhfgR7yZhUvLyWqM6lhzpL6f7jTUD9IStvAhTUpLq LY8ZNI0pO0uQDljqmoQnTk1tro2dblzDTWmhlOm2BobW+aU+LnLS9oDJ8gBPKE1V J4beS3a2eNwORg== -----END CERTIFICATE REQUEST-----"; $params = array(); $params['requestHeader'] = $requestHeader; © 2013 Networking4all - www.networking4all.com pagina 69 van 99 $params['request']['productCode'] = 1630; $params['request']['csr'] = utf8_encode($csr); $response = $client->checkSSLCertificateCSR($params); ?> 7.5.4Het Approver Email adres Als de CSR is gecontroleerd vragen we een lijst aan met de Approver Email adressen, waarvan we er 1 moeten opgeven bij de bestelling van het SSL certificaat. Hiervoor hebben we de domeinnaam nodig, ook wel de Common Name genoemd. In dit voorbeeld gebruiken we www.networking4all.com <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['productCode'] = 1630; $params['request']['domain'] = utf8_encode('www.networking4all.com'); $response = $client->getSSLCertificateApproverList($params); ?> 7.5.5SSL Certificaat bestellen Nu hebben we alle gegevens voor het bestellen van een SSL Certificaat via de API. Deze gegevens zijn: Company : TST-000001 Admin Contact : TST-000002 Tech Contact : TST-000002 ApproverEmail : hostmaster@networking4all.com We gebruiken hetzelfde contact als administratief en technisch contact in dit voorbeeld. U kunt natuurlijk voor beiden een eigen contact aanmaken. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); © 2013 Networking4all - www.networking4all.com pagina 70 van 99 $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $csr = "-----BEGIN CERTIFICATE REQUEST----MIIB5jCCAU8CAQAwgaUxCzAJBgNVBAYTAk5MMRYwFAYDVQQIEw1Ob29yZCBCcmFi YW50MRMwEQYDVQQHEwpSb29zZW5kYWFsMRwwGgYDVQQKExNOZXR3b3JraW5nNGFs bCBCLlYuMR8wHQYDVQQDExZ3d3cubmV0d29ya2luZzRhbGwuY29tMSowKAYJKoZI hvcNAQkBFhtzZWN1cml0eUBuZXR3b3JraW5nNGFsbC5jb20wgZ8wDQYJKoZIhvcN AQEBBQADgY0AMIGJAoGBAOsi6VgMka2KLata8fn0zeXbwbmjcTKd6V973Jrm4mCk PAjFklWyGdXirtHV+Etbuiu7/WAEgwCVJK46tjMK+ZPpmt1f/kXxIUgjtZTaTS+r Cfzoyl85MZSKXNhIMOICvkn7m4YXyQDMXLearR+XVa2pnJ0MwpEnAeh8YEsps/Pp AgMBAAGgADANBgkqhkiG9w0BAQQFAAOBgQC3lC2dW6smhPD3SFXY0ypw9f7xnieL cosYjN0O/yos9NlflGsV0LuZhfgR7yZhUvLyWqM6lhzpL6f7jTUD9IStvAhTUpLq LY8ZNI0pO0uQDljqmoQnTk1tro2dblzDTWmhlOm2BobW+aU+LnLS9oDJ8gBPKE1V J4beS3a2eNwORg== -----END CERTIFICATE REQUEST-----"; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['companyHandle'] = utf8_encode('TST-000001'); $params['request']['adminHandle'] = utf8_encode('TST-000002'); $params['request']['techHandle'] = utf8_encode('TST-000002'); $params['request']['productCode'] = 1630; $params['request']['csr'] =utf8_encode($csr); $params['request']['period'] = 1; $params['request']['approverEmail'] = utf8_encode('hostmaster@networking4all.com'); $response = $client->orderSSLCertificate($params); ?> Na de uitvoering van deze bestelling krijgen we van de API een traceNumber als respons: 10000000001. Dit traceNumber is nodig voor de functies resendEmailSSLCertificate, replaceSSLCertificate en getSSLCertificateOrder. 7.5.6Order the SSL Certificate (DV) with automatic Domain Approval Now we are ready to order a SSL Certificate using the API. We have the following data: Company Admin Contact Tech Contact : : : TST-000001 TST-000002 TST-000002 We will use the same contact for administrative contact and tech contact in this example. Of course you could create and/or use a different contact for both. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); © 2013 Networking4all - www.networking4all.com pagina 71 van 99 $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $csr = "-----BEGIN CERTIFICATE REQUEST----MIIB5jCCAU8CAQAwgaUxCzAJBgNVBAYTAk5MMRYwFAYDVQQIEw1Ob29yZCBCcmFi YW50MRMwEQYDVQQHEwpSb29zZW5kYWFsMRwwGgYDVQQKExNOZXR3b3JraW5nNGFs bCBCLlYuMR8wHQYDVQQDExZ3d3cubmV0d29ya2luZzRhbGwuY29tMSowKAYJKoZI hvcNAQkBFhtzZWN1cml0eUBuZXR3b3JraW5nNGFsbC5jb20wgZ8wDQYJKoZIhvcN AQEBBQADgY0AMIGJAoGBAOsi6VgMka2KLata8fn0zeXbwbmjcTKd6V973Jrm4mCk PAjFklWyGdXirtHV+Etbuiu7/WAEgwCVJK46tjMK+ZPpmt1f/kXxIUgjtZTaTS+r Cfzoyl85MZSKXNhIMOICvkn7m4YXyQDMXLearR+XVa2pnJ0MwpEnAeh8YEsps/Pp AgMBAAGgADANBgkqhkiG9w0BAQQFAAOBgQC3lC2dW6smhPD3SFXY0ypw9f7xnieL cosYjN0O/yos9NlflGsV0LuZhfgR7yZhUvLyWqM6lhzpL6f7jTUD9IStvAhTUpLq LY8ZNI0pO0uQDljqmoQnTk1tro2dblzDTWmhlOm2BobW+aU+LnLS9oDJ8gBPKE1V J4beS3a2eNwORg== -----END CERTIFICATE REQUEST-----"; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['companyHandle'] = utf8_encode('TST-000001'); $params['request']['adminHandle'] = utf8_encode('TST-000002'); $params['request']['techHandle'] = utf8_encode('TST-000002'); $params['request']['productCode'] = 1630; $params['request']['csr'] =utf8_encode($csr); $params['request']['period'] = 1; $params['request']['option']['approverMethod'] = utf8_encode("FILE"); $response = $client->orderSSLCertificate($params); ?> Now we have ordered a SSL Certificate, and we get a traceNumber in return: 10000000001. This traceNumber is needed for resendEmailSSLCertificate, replaceSSLCertificate and getSSLCertificateOrder operations. You will also get a fileName and fileContent back in the response. You need to create this file and copy it to the public root folder of your website. 7.5.7Opnieuw inzenden of wijzigen van het Approver Email adres Om de Approver Email te wijzigen is het traceNumber nodig dat verkregen is in respons op de bestelling. Het wijzigen van het Approver Email adres is optioneel. In dit voorbeeld gaan we het veranderen naar webmaster@networking4all.com . <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; © 2013 Networking4all - www.networking4all.com pagina 72 van 99 $params['request']['traceNumber'] = 10000000001; $params['request']['approverEmail'] = utf8_encode('webmaster@networking4all.com'); $response = $client->resendEmailSSLCertificate($params); ?> 7.5.8Een SSL Certificaat vervangen In dit laatste voorbeeld laten we zien hoe een SSL certificaat vervangen kan worden. Ook hiervoor is het traceNumber nodig dat in respons op de bestelling werd verstuurd. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $csr = "-----BEGIN CERTIFICATE REQUEST----MIIB5jCCAU8CAQAwgaUxCzAJBgNVBAYTAk5MMRYwFAYDVQQIEw1Ob29yZCBCcmFi YW50MRMwEQYDVQQHEwpSb29zZW5kYWFsMRwwGgYDVQQKExNOZXR3b3JraW5nNGFs bCBCLlYuMR8wHQYDVQQDExZ3d3cubmV0d29ya2luZzRhbGwuY29tMSowKAYJKoZI hvcNAQkBFhtzZWN1cml0eUBuZXR3b3JraW5nNGFsbC5jb20wgZ8wDQYJKoZIhvcN AQEBBQADgY0AMIGJAoGBAOsi6VgMka2KLata8fn0zeXbwbmjcTKd6V973Jrm4mCk PAjFklWyGdXirtHV+Etbuiu7/WAEgwCVJK46tjMK+ZPpmt1f/kXxIUgjtZTaTS+r Cfzoyl85MZSKXNhIMOICvkn7m4YXyQDMXLearR+XVa2pnJ0MwpEnAeh8YEsps/Pp AgMBAAGgADANBgkqhkiG9w0BAQQFAAOBgQC3lC2dW6smhPD3SFXY0ypw9f7xnieL cosYjN0O/yos9NlflGsV0LuZhfgR7yZhUvLyWqM6lhzpL6f7jTUD9IStvAhTUpLq LY8ZNI0pO0uQDljqmoQnTk1tro2dblzDTWmhlOm2BobW+aU+LnLS9oDJ8gBPKE1V J4beS3a2eNwORg== -----END CERTIFICATE REQUEST-----"; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['traceNumber'] = 10000000001; $params['request']['csr'] = utf8_encode($csr); $params['request']['approverEmail'] = utf8_encode('webmaster@networking4all.com'); $response = $client->replaceSSLCertificate($params); ?> 7.5.9Procedure voor het bestellen van een SAN certificaat In dit en de volgende voorbeelden, zullen we een SAN certificaat bestellen. We gaan uit van een Networking4all Pro San certificaat, met productCode 1648. <?php error_reporting(E_ALL); © 2013 Networking4all - www.networking4all.com pagina 73 van 99 ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $csr = "-----BEGIN CERTIFICATE REQUEST----MIIB5jCCAU8CAQAwgaUxCzAJBgNVBAYTAk5MMRYwFAYDVQQIEw1Ob29yZCBCcmFi YW50MRMwEQYDVQQHEwpSb29zZW5kYWFsMRwwGgYDVQQKExNOZXR3b3JraW5nNGFs bCBCLlYuMR8wHQYDVQQDExZ3d3cubmV0d29ya2luZzRhbGwuY29tMSowKAYJKoZI hvcNAQkBFhtzZWN1cml0eUBuZXR3b3JraW5nNGFsbC5jb20wgZ8wDQYJKoZIhvcN AQEBBQADgY0AMIGJAoGBAOsi6VgMka2KLata8fn0zeXbwbmjcTKd6V973Jrm4mCk PAjFklWyGdXirtHV+Etbuiu7/WAEgwCVJK46tjMK+ZPpmt1f/kXxIUgjtZTaTS+r Cfzoyl85MZSKXNhIMOICvkn7m4YXyQDMXLearR+XVa2pnJ0MwpEnAeh8YEsps/Pp AgMBAAGgADANBgkqhkiG9w0BAQQFAAOBgQC3lC2dW6smhPD3SFXY0ypw9f7xnieL cosYjN0O/yos9NlflGsV0LuZhfgR7yZhUvLyWqM6lhzpL6f7jTUD9IStvAhTUpLq LY8ZNI0pO0uQDljqmoQnTk1tro2dblzDTWmhlOm2BobW+aU+LnLS9oDJ8gBPKE1V J4beS3a2eNwORg== -----END CERTIFICATE REQUEST-----"; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['productCode'] = 1648; $params['request']['csr'] = utf8_encode($csr); $params['request']['san'] = array(utf8_encode('test1.networking4all.com'), utf8_encode('test2.networking4all.com'), utf8_encode('test3.networking4all.com')); $response = $client->checkSSLCertificateCSR($params); ?> 7.5.10Het verkrijgen van de ApproverList voor een SAN certificaat <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['productCode'] = 1648; $params['request']['domain'] = utf8_encode('www.networking4all.com'); © 2013 Networking4all - www.networking4all.com pagina 74 van 99 $response = $client->getSSLCertificateApproverList($params); ?> 7.5.11Bestelling van het SAN certificaat De bestelling van het SAN certificaat met orderSSLCertificate. In dit voorbeeld gaan we uit van dezelfde gegevens die in de vorige voorbeelden hebben verkregen, namelijk: Company Admin Contact Tech Contact ApproverEmail : : : : TST-000001 TST-000002 TST-000002 hostmaster@networking4all.com <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $csr = "-----BEGIN CERTIFICATE REQUEST----MIIB5jCCAU8CAQAwgaUxCzAJBgNVBAYTAk5MMRYwFAYDVQQIEw1Ob29yZCBCcmFi YW50MRMwEQYDVQQHEwpSb29zZW5kYWFsMRwwGgYDVQQKExNOZXR3b3JraW5nNGFs bCBCLlYuMR8wHQYDVQQDExZ3d3cubmV0d29ya2luZzRhbGwuY29tMSowKAYJKoZI hvcNAQkBFhtzZWN1cml0eUBuZXR3b3JraW5nNGFsbC5jb20wgZ8wDQYJKoZIhvcN AQEBBQADgY0AMIGJAoGBAOsi6VgMka2KLata8fn0zeXbwbmjcTKd6V973Jrm4mCk PAjFklWyGdXirtHV+Etbuiu7/WAEgwCVJK46tjMK+ZPpmt1f/kXxIUgjtZTaTS+r Cfzoyl85MZSKXNhIMOICvkn7m4YXyQDMXLearR+XVa2pnJ0MwpEnAeh8YEsps/Pp AgMBAAGgADANBgkqhkiG9w0BAQQFAAOBgQC3lC2dW6smhPD3SFXY0ypw9f7xnieL cosYjN0O/yos9NlflGsV0LuZhfgR7yZhUvLyWqM6lhzpL6f7jTUD9IStvAhTUpLq LY8ZNI0pO0uQDljqmoQnTk1tro2dblzDTWmhlOm2BobW+aU+LnLS9oDJ8gBPKE1V J4beS3a2eNwORg== -----END CERTIFICATE REQUEST-----"; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['companyHandle'] = utf8_encode('TST-000001'); $params['request']['adminHandle'] = utf8_encode('TST-000002'); $params['request']['techHandle'] = utf8_encode('TST-000002'); $params['request']['productCode'] = 1648; $params['request']['csr'] =utf8_encode($csr); $params['request']['san'] = array(utf8_encode('test1.networking4all.com'), utf8_encode('test2.networking4all.com'), utf8_encode('test3.networking4all.com')); $params['request']['period'] = 1; $params['request']['approverEmail'] = utf8_encode('hostmaster@networking4all.com'); $response = $client->orderSSLCertificate($params); ?> © 2013 Networking4all - www.networking4all.com pagina 75 van 99 Na de uitvoering van deze bestelling krijgen we van de API een traceNumber als respons: 10000000001. Dit traceNumber is nodig voor de functies resendEmailSSLCertificate, replaceSSLCertificate en getSSLCertificateOrder. 7.5.12Raadpleeg de API voor de status van de bestelling en het certificaat Met deze functie kunt u de API vragen naar de status van uw bestelling en indien de status 216 is (Certificaat is uitgegeven) dan kunt u het certificaat aldus verkrijgen. U heeft hiervoor het traceNumber nodig, wat als respons verstuurd is bij de orderSSLCertificate functie. U kunt dit ook overslaan aangezien het certificaat tevens altijd per e-mail wordt verzonden zodra het is uitgegeven. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['traceNumber'] = 10000000001; $response = $client->getSSLCertificate($params); ?> 7.5.13Raadpleeg de API voor een lijst met SSLCerticates bestellingen Met deze functie kunt u de API vragen naar alle SSLCerticates orders die zijn geplaatst, en de respectievelijke status en het certificaat ophalen. In plaats van het traceNumber die u moet opgeven in getSSLCertificateOrder geeft u hier een datum range, status of handle op om een lijst met certificaten op te vragen. Dit is optioneel, maar wel aangeraden om het aantal resultaten te limiteren. In dit voorbeeld gebruiken we de datum. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; © 2013 Networking4all - www.networking4all.com pagina 76 van 99 $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['fromDate'] = '2010-01-01'; $params['request']['toDate'] = '2010-01-13'; $response = $client->getSSLCertificateList($params); ?> 7.5.14Wijzig uw malware scan opties Deze functie maakt het mogelijk om de malware scan opties te wijzigen. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['traceNumber'] = 10000000001; $params['request']['action'] = utf8_encode('UPDATE_EXTRA_PREFERENCES'); $params['request']['extraPreferences'] = utf8_encode('MS_DISABLED'); $response = $client->updateSSLCertificate($params); ?> 7.5.15Vraag een On-Demand-Scan aan Deze functie maakt het mogelijk om een On-Demand-Scan aan te vragen. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); © 2013 Networking4all - www.networking4all.com pagina 77 van 99 $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['traceNumber'] = 10000000001; $params['request']['action'] = utf8_encode('REQUEST_ON_DEMAND_SCAN'); $response = $client->updateSSLCertificate($params); ?> 7.5.16Voeg een extra SAN naam toe aan uw certificaat. Deze functie maakt het mogelijk SAN namen toe te voegen/te verwijderen in uw SAN Certificaat. Het is belangrijk om te weten dat u alle SAN namen die u wilt behouden mee moet geven aan de functie, plus de nieuwe namen. SAN namen die u weglaat zullen worden verwijderd uit het certificaat als het certificaat opnieuw uitgegeven word. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['traceNumber'] =utf8_encode(10000000001); // Add test4.networking4all.com $params['request']['san'] = array(utf8_encode('test1.networking4all.com'), utf8_encode('test2.networking4all.com'), utf8_encode('test3.networking4all.com'), utf8_encode('test4.networking4all.com')); $response = $client->changeSANSSLCertificate($params); ?> 7.5.17Order a GlobalSign PersonalSign certificate. Ordering the PersonalSign Certificate. In this example we will use the same data as we used in our previous examples: Company Admin Contact Tech Contact : : : TST-000001 TST-000002 TST-000002 <?php © 2013 Networking4all - www.networking4all.com pagina 78 van 99 error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params['request']['companyHandle'] = utf8_encode('TST-000001'); $params['request']['adminHandle'] = utf8_encode('TST-000002'); $params['request']['techHandle'] = utf8_encode('TST-000002'); $params['request']['productCode'] = 1844; $params['request']['period'] = 1; /* * Fields for GlobalSign PersonalSign (PS2Pro example) */ $params['request']['commonName'] = utf8_encode('Test Person'); $params['request']['title'] = utf8_encode('Dhr'); $params['request']['locality'] = utf8_encode('Amsterdam'); $params['request']['stateOrProvince'] = utf8_encode('Noord-Holland'); $params['request']['country'] = utf8_encode('NL'); $params['request']['email'] = utf8_encode('test@testcompany.com'); $response = $client->orderSSLCertificate($params); ?> 7.5.18Bestel een GlobalSign CodeSigning certificaat. Het bestellen van het CodeSigning Certificaat. In dit voorbeeld gebruiken we dezelfde gegevens als we in voorgaande voorbeelden hebben gebruikt: Company Admin Contact Tech Contact : : : TST-000001 TST-000002 TST-000002 <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; © 2013 Networking4all - www.networking4all.com pagina 79 van 99 $params['request']['companyHandle'] = utf8_encode('TST-000001'); $params['request']['adminHandle'] = utf8_encode('TST-000002'); $params['request']['techHandle'] = utf8_encode('TST-000002'); $params['request']['productCode'] = 1850; $params['request']['period'] = 1; /* * Fields for GlobalSign CodeSigning (CodeSigning Organisation example) */ $params['request']['certificateType'] = utf8_encode('OSJAVA'); $params['request']['commonName'] = utf8_encode('Test company B.V.'); $params['request']['organizationUnit'] = utf8_encode('Test'); // Optional $params['request']['locality'] = utf8_encode('Amsterdam'); $params['request']['stateOrProvince'] = utf8_encode('Noord-Holland'); $params['request']['country'] = utf8_encode('NL'); $params['request']['email'] = utf8_encode('test@testcompany.com'); $response = $client->orderSSLCertificate($params); ?> 7.6Code voorbeelden domeinnamen In dit voorbeeld maken we een nieuw bedrijf en contactpersoon aan, voordat we de domeinna(a)m(en) controleren en bestellen. In ons laatste voorbeeld veranderen we de nameservers, nadat de domeinnaam is geregistreerd. 7.6.1Maak een nieuw bedrijf aan In dit voorbeeld zullen we een nieuw bedrijf aanmaken. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['type'] = utf8_encode('company'); /* * Company information */ $params['request']['company']['name'] = utf8_encode('Test company'); $params['request']['company']['employees'] = 2; $params['request']['company']['chamberOfCommerce'] = ''; /* * Address information */ $address = array(); $address['type'] = utf8_encode('visit'); $address['street1'] = utf8_encode('Testlaan 562'); © 2013 Networking4all - www.networking4all.com pagina 80 van 99 $address['postalCode'] = utf8_encode('0000 EN'); $address['city'] = utf8_encode('Den Haag'); $address['province'] = utf8_encode('Zuid Holland'); $address['countryCode'] = utf8_encode('NL'); $params['request']['address'][] = $address; /* * Address information (optional) */ $address = array(); $address['type'] = utf8_encode('post'); $address['street1'] = utf8_encode('Postbus 00000'); $address['postalCode'] = utf8_encode('0000 EN'); $address['city'] = utf8_encode('Amsterdam'); $address['province'] = utf8_encode('Noord Holland'); $address['countryCode'] = utf8_encode('NL'); $params['request']['address'][] = $address; /* * Phone number */ $params['request']['phoneNumber'] = '31307000000'; /* * Fax number */ $params['request']['faxNumber'] = '312070000000'; /* * Mobile number */ $params['request']['mobileNumber'] = '316001000000'; /* * Digital contact information */ $params['request']['email'] = utf8_encode('info@testcompany.com'); $params['request']['website'] = ''; /* * Bank financial information */ $params['request']['financial']['accountNumber'] = '0000000'; $params['request']['financial']['accountType'] = utf8_encode('GIRO'); $params['request']['financial']['bicCode'] = ''; $params['request']['financial']['ibanNumber'] = ''; $params['request']['financial']['vatin'] = ''; $response = $client->createRelation($params); ?> Dit verzoek heeft een bedrijf gecreëerd en geeft de handle terug: TST-000001 (in dit voorbeeld) 7.6.2Een contactpersoon aanmaken In dit voorbeeld zullen we enkel een contactpersoon aanmaken, gekoppeld aan het bedrijf hierboven. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; © 2013 Networking4all - www.networking4all.com pagina 81 van 99 $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['type'] = utf8_encode('contact'); /* * Handle to link this contact to company */ $params['request']['handle'] = utf8_encode('TST-000001'); /* * Contact */ $params['request']['contact']['title'] = utf8_encode('Dhr'); $params['request']['contact']['initials'] = utf8_encode('D'); $params['request']['contact']['firstName'] = utf8_encode('David'); $params['request']['contact']['middleName'] = ''; $params['request']['contact']['lastName'] = utf8_encode('Test'); $params['request']['contact']['gender'] = utf8_encode('M'); $params['request']['contact']['birthDate'] = utf8_encode('1981-01-01'); /* * Address information */ $address = array(); $address['type'] = utf8_encode('visit'); $address['street1'] = utf8_encode('Testlaan 562'); $address['postalCode'] = utf8_encode('0000 EN'); $address['city'] = utf8_encode('Den Haag'); $address['province'] = utf8_encode('Zuid Holland'); $address['countryCode'] = utf8_encode('NL'); $params['request']['address'][] = $address; /* * Phone number */ $params['request']['phoneNumber'] = '31207000000'; /* * Fax number */ $params['request']['faxNumber'] = '31207000000'; /* * Mobile number */ $params['request']['mobileNumber'] = '316001000000'; /* * Digital contact information */ $params['request']['email'] = utf8_encode('david@yourdomain.com'); $params['request']['website'] = ''; /* * Login account */ $params['request']['account']['username'] = utf8_encode('daid81'); © 2013 Networking4all - www.networking4all.com pagina 82 van 99 $params['request']['account']['password'] = utf8_encode('paS$wd81'); $params['request']['account']['passwordConfirm'] = utf8_encode('paS$wd81'); /* * Options */ $params['request']['option']['createAccount'] = 1; $response = $client->createRelation($params); ?> Dit verzoek maakt een contactpersoon voor het bedrijf aan en geeft de handle terug: TST-000002 (in dit voorbeeld). 7.6.3Controleer de beschikbaarheid van de domeinnaam Controleer of de domeinnaam beschikbaar is. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['domain'][] = utf8_encode('testdomain.com'); $response = $client->checkDomain($params); ?> 7.6.4Bestel een domeinnaam U bent nu klaar om een domeinnaam aan te vragen, aan de hand van de API. We hebben de volgende gegevens: Company Admin Contact Tech Contact : : : TST-000001 TST-000002 TST-000002 In dit voorbeeld is de administratieve contactpersoon dezelfde als de technische contactpersoon. U kunt uiteraard twee verschillende contactpersonen gebruiken. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); © 2013 Networking4all - www.networking4all.com pagina 83 van 99 use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['companyHandle'] = utf8_encode('TST-000001'); $params['request']['adminHandle'] = utf8_encode('TST-000002'); $params['request']['techHandle'] = utf8_encode('TST-000002'); $params['request']['action'] = utf8_encode('register'); $params['request']['domain'] = utf8_encode('testdomain.com'); /* * If no nameServers are specified our default * (example uses our default nameServers) */ $params['request']['nameServers'][0]['ns'] = utf8_encode('ns1.networking4alol.com'); $params['request']['nameServers'][0]['ipv4'] = $params['request']['nameServers'][1]['ns'] = utf8_encode('ns2.networking4alol.net'); $params['request']['nameServers'][1]['ipv4'] = $params['request']['nameServers'][2]['ns'] = utf8_encode('ns3.networking4alol.org'); $params['request']['nameServers'][2]['ipv4'] = nameServers are used. utf8_encode('213.249.65.162'); utf8_encode('91.185.130.195'); utf8_encode('213.249.,64,19'); $response = $client->orderDomain($params); ?> 7.6.5De nameServers veranderen Verander de nameservers nadat uw domeinnaam is geregistreerd. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['domain'] = utf8_encode('testdomain.com'); © 2013 Networking4all - www.networking4all.com pagina 84 van 99 $params['request']['nameServers'][0]['ns'] = utf8_encode('ns1.networking4alol.com'); $params['request']['nameServers'][0]['ipv4'] = utf8_encode('213.249.65.162'); $params['request']['nameServers'][1]['ns'] = utf8_encode('ns2.networking4alol.net'); $params['request']['nameServers'][1]['ipv4'] = utf8_encode('91.185.130.195'); $params['request']['nameServers'][2]['ns'] = utf8_encode('ns3.networking4alol.org'); $params['request']['nameServers'][2]['ipv4'] = utf8_encode('213.249.,64,19'); $response = $client->nameServerChange($params); ?> 7.6.6Query the API for your domain Order status and domain info After ordering your domain you can use the traceNumber returned with the orderDomain operation or the domain name to request the status and domain info. In this example we use the traceNumber. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['traceNumber'] = 10000000001; $response = $client->getDomain($params); ?> 7.6.7Raadpleeg de API voor een lijst met Domeinnaam bestellingen Met deze functie kunt u de API vragen naar alle Domeinnaam bestellingen die zijn geplaatst, en de respectievelijke status. In plaats van het traceNumber die u moet opgeven in getDomainOrder geeft u hier een datum range, status of handle op om een lijst met certificaten op te vragen. Dit is optioneel, maar wel aangeraden om het aantal resultaten te limiteren. In dit voorbeeld gebruiken we de datum. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; © 2013 Networking4all - www.networking4all.com pagina 85 van 99 $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['fromDate'] = '2010-01-01'; $params['request']['toDate'] = '2010-01-13'; $response = $client->getDomainList($params); ?> 7.6.8Update domeinnaam handles. U kunt de domeinnaam Admin Contact en Tech Contact updaten door gebruik te maken van de updateDomain functie. Voor dit voorbeeld gebruiken we de onderstaande gegevens. Maak of bewerkt eerst de contact gegevens voordat u de domeinnaam handles gaat updaten. Admin Contact Tech Contact : : TST-000003 TST-000003 In dit voorbeeld is de administratieve contactpersoon dezelfde als de technische contactpersoon. U kunt uiteraard twee verschillende contactpersonen gebruiken. <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['domain'] = utf8_encode('testdomain.com'); $params['request']['adminHandle'] = utf8_encode('TST-000003'); $params['request']['techHandle'] = utf8_encode('TST-000003'); $response = $client->updateDomain($params); ?> 7.6.9Opzeggen domeinnaam U kunt met deze functie uw domeinnaam opzeggen. © 2013 Networking4all - www.networking4all.com pagina 86 van 99 <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['domain'] = utf8_encode('testdomain.com'); $response = $client->cancelDomain($params); ?> 7.6.10Haal DNS records op van een domein <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['domain'] = utf8_encode('testdomain.com'); $response = $client->getDnsRecords($params); ?> 7.6.11Voeg één of meerdere DNS records toe aan een domein <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); © 2013 Networking4all - www.networking4all.com pagina 87 van 99 $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['domain'] = utf8_encode('testdomain.com'); $params['request']['dnsrecords']['dnsrecord'][0]['name'] = utf8_encode( 'subdomain.testdomain.com' ); $params['request']['dnsrecords']['dnsrecord'][0]['ttl'] = utf8_encode( '300' ); $params['request']['dnsrecords']['dnsrecord'][0]['type'] = utf8_encode( 'cname' ); $params['request']['dnsrecords']['dnsrecord'][0]['value'] = utf8_encode( '127.0.0.1' ); $response = $client->addDnsRecords( $params ); ?> 7.6.12Update één of meerdere bestaande DNS records van een domein <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['domain'] = utf8_encode(testdomain.com'); $params['request']['dnsrecords']['dnsrecord'][0]['old']['name'] = utf8_encode( 'subdomain.testdomain.com' ); $params['request']['dnsrecords']['dnsrecord'][0]['old']['ttl'] = utf8_encode( '300' ); $params['request']['dnsrecords']['dnsrecord'][0]['old']['type'] = utf8_encode( 'cname' ); $params['request']['dnsrecords']['dnsrecord'][0]['old']['value'] = utf8_encode( '127.0.0.1' ); $params['request']['dnsrecords']['dnsrecord'][0]['new']['name'] = utf8_encode( domainsub.testdomain.com' ); $params['request']['dnsrecords']['dnsrecord'][0]['new']['ttl'] = utf8_encode( '600' ); $params['request']['dnsrecords']['dnsrecord'][0]['new']['type'] = © 2013 Networking4all - www.networking4all.com pagina 88 van 99 utf8_encode( 'cname' ); $params['request']['dnsrecords']['dnsrecord'][0]['new']['value'] = utf8_encode( '10.0.0.1' ); $response = $client->updateDnsRecords($params); ?> 7.6.13Verwijder één of meerdere bestaande DNS records van een domein <?php error_reporting(E_ALL); ini_set("soap.wsdl_cache_enabled", "0"); use_soap_error_handler(true); $url = 'https://www.networking4all.com/api/soap/api.wsdl'; $client = new SoapClient($url, array('trace' => 1)); $requestHeader = array(); $requestHeader['auth']['handle'] = utf8_encode('TST-000000'); $requestHeader['auth']['username'] = utf8_encode('username'); $requestHeader['auth']['password'] = utf8_encode('password'); $requestHeader['language'] = utf8_encode('NL'); $requestHeader['reference'] = utf8_encode('My Reference'); $requestHeader['test'] = 1; $params = array(); $params['requestHeader'] = $requestHeader; $params['request']['domain'] = utf8_encode(testdomain.com'); $params['request']['dnsrecords']['dnsrecord'][0]['name'] = utf8_encode( 'subdomain.testdomain.com' ); $params['request']['dnsrecords']['dnsrecord'][0]['ttl'] = utf8_encode( '600' ); $params['request']['dnsrecords']['dnsrecord'][0]['type'] = utf8_encode( 'cname' ); $params['request']['dnsrecords']['dnsrecord'][0]['value'] = utf8_encode( '10.0.0.1' ); $response = $client->deleteDnsRecords($params); ?> 7.7UTF-8 encoding en decoding De op SOAP gebaseerde API heeft geldige UTF-8 encoded tekenreeksen nodig in het request, zoals te zien in de code voorbeelden in sectie 4.5. In principe hoeven alleen tekenreeksen met speciale karakters encoded te worden. Vaak komt de informatie uit een database of een web formulier, en tenzij alle speciale karakters er handmatig uitgehaald worden, is het meestal beter om alle informatie UTF-8 te encoden in het request naar de API. Is niet alles encoded dan zal er een XML foutmelding optreden aan de SOAP Client kant, aangezien het request toch speciale karakters bevat. Gebruik hiervoor de utf8_encode() functie in PHP of een soortgelijke functie in andere programmeertalen. Vanaf de andere kant, bestaat de respons van de API uitsluitend uit UTF-8 encoded tekenreeksen, deze wilt u mogelijk eerst decoden voordat u ze gebruikt. Hiervoor kan de utf8_decode() functie in PHP gebruikt worden, of een soortgelijke functie in andere programmeertalen. © 2013 Networking4all - www.networking4all.com pagina 89 van 99 8 Product informatie 8.1Product codes Hieronder volgt een lijst van productCodes van de SSL Certificaten die via de Networking4all API besteld kunnen worden. Meer informatie en prijzen zijn te vinden op onze website: www.networking4all.com 8.1.1DV (Domain Validatie) SSL Certificaten Domeinnaam gevalideerde SSL Certificaten zijn SSL Certificaten welke zeer snel kunnen worden uitgegeven, meestal binnen enkele minuten. Iedereen kan een aanvraag indienen voor een SSL certificaat, maar certificaat aanvragen moeten worden goedgekeurd door iemand binnen de organisatie, die controle heeft over de domeinnaam. Doorgaans is dit de webmaster of de persoon die de domeinnaam heeft geregistreerd. Selecteer een Approver Email uit de lijst die verkrijgbaar is via de functie getSSLCertificateApproverList. Naar het Approver Email adres wordt een email ter validatie gestuurd om de aanvraag van het SSL certificaat goed te keuren. Merk SSL Certificaat ProductCod Periode e Licensie Approver Email Networking4all Regular Lite 1620 1 tot 5 jaar Onbeperkt ja(file) Networking4all Regular Lite Wildcard 1625 1 tot 5 jaar Onbeperkt ja(file) Networking4all Regular Basic 1630 1 tot 5 jaar Onbeperkt ja(file) Networking4all Regular Basic Wildcard 1635 1 tot 5 jaar Onbeperkt ja(file) Networking4all Regular Pro 1640 1 tot 5 jaar Onbeperkt ja(file) Networking4all Regular Pro Wildcard 1645 1 tot 5 jaar Onbeperkt ja Networking4all Regular Pro SAN 1648 1 tot 5 jaar Onbeperkt ja Networking4all Trial 1650 0 Onbeperkt ja Networking4all Trial Mobile 1651 0 Onbeperkt ja GeoTrust Quick SSL Premium 1520 1 tot 5 jaar Onbeperkt ja(file) GeoTrust QuickSSL Premium SAN 1590 1 tot 4 jaar Onbeperkt ja(file) Thawte Thawte SSL 123 1720 1 tot 5 jaar 1 t/m 499 GlobalSign DomainSSL 1800 1 tot 5 jaar Onbeperkt ja* GlobalSign DomainSSL Wildcard 1805 1 tot 5 jaar Onbeperkt ja* GlobalSign DomainSSL SAN 1807 1 tot 5 jaar Onbeperkt ja* ja(file) * Geeft aan dat het approverEmail adres niet gewijzigd kan worden met de resendEmailSSLCertificate functie, alleen het originele approverEmail adres kan opnieuw verzonden worden. 8.1.2OV (Organisation Validatie) SSL Certificaten Bij organisatie gevalideerde certificaten controleren wij onder andere de gegevens van de organisatie door middel van externe bronnen en wordt de contactpersoon van de organisatie opgebeld. Merk SSL Certificaat ProductCod Period e Licensie Approver Email Networking4all Business Intranet 1121 1 jaar Onbeperkt nee Networking4all Business Basic SSL 1632 1 tot 5 jaar Onbeperkt nee Networking4all Business Basic SSL 1634 1 tot 5 jaar Onbeperkt nee © 2013 Networking4all - www.networking4all.com pagina 90 van 99 Wildcard Networking4all Business Basic SSL SAN 1633 1 tot 5 jaar Onbeperkt nee Symantec Secure Site 1750 1 tot 5 jaar 1 tot 499 nee Symantec Secure Site Pro 1760 1 tot 5 jaar 1 tot 499 nee Symantec Secure Site SAN 1752 1 tot 4 jaar 1 tot 499 nee Symantec Secure Site PRO SAN 1762 1 tot 4 jaar 1 tot 499 nee GeoTrust True Business ID 1530 1 tot 5 jaar Onbeperkt nee GeoTrust True Business ID Wildcard 1540 1 tot 5 jaar Onbeperkt nee Thawte Webserver 1700 1 tot 5 jaar 1 tot 499 nee Thawte Webserver Wildcard 1705 1 tot 5 jaar 1 tot 499 nee Thawte SGC Supercert 1710 1 tot 5 jaar 1 tot 499 nee Thawte SCG SuperCert SAN 1712 1 tot 4 jaar 1 tot 499 nee Thawte Web Server SAN 1702 1 tot 4 jaar 1 tot 499 nee GlobalSign OrganisationSSL 1810 1 tot 5 jaar Onbeperkt nee GlobalSign OrganisationSSL Wildcard 1815 1 tot 5 jaar Onbeperkt nee GlobalSign OrganisationSSL SAN 1817 1 tot 5 jaar Onbeperkt nee 8.1.3EV (Extended Validation) SSL Certificaten Een Extended Validation SSL Certificaat laat de adresbalk van bijvoorbeeld de Internet Explorer 7 browser groen kleuren. Dit houdt in dat de identiteit van de eigenaar van de website welke in het SSL Certificaat vermeld staat is gevalideerd door middel van de zeer strenge Extended Validation richtlijnen. Merk SSL Certificaat ProductCod Periode e Networking4all Business Pro SSL 1643 (voorheen 1646) 1 tot 2 jaar Onbeperkt nee Networking4all Business Pro SSL SAN 1642 (voorheen 1644) 1 tot 2 jaar Onbeperkt nee Symantec Secure Site EV 1770 1 tot 2 jaar 1 tot 499 nee Symantec Secure Site Pro EV 1780 1 tot 2 jaar 1 tot 499 nee Symantec Secure Site EV SAN 1772 1 tot 2 jaar 1 tot 499 nee Symantec Secure Site Pro EV SAN 1782 1 tot 2 jaar 1 tot 499 nee GeoTrust True Business ID EV 1550 1 tot 2 jaar Onbeperkt nee Thawte Webserver EV 1703 1 tot 2 jaar 1 tot 499 nee Thawte Web Server EV SAN 1707 1 tot 2 jaar 1 tot 499 nee GlobalSign ExtendedSSL 1820 1 tot 2 jaar Onbeperkt nee GlobalSign ExtendedSSL SAN 1827 1 tot 2 jaar Onbeperkt nee © 2013 Networking4all - www.networking4all.com Licensie Approver Email pagina 91 van 99 8.1.4Client certificaten Client certificaten zijn certificaten waarmee u uw email of uw codes kunt signen. Wanneer u een CodeSigning of PersonalSign certificaat van GlobalSign aanschaft wordt een pickupPassword gegenereerd welke terug zal komen in de response. U heeft dit pickupPassword nodig om uw certificaat te verkrijgen! Merk SSL Certificaat ProductCode Periode Approver Symantec CodeSigning 1790 1 to 2 yrs nee Thawte CodeSigning 1730 1 to 2 yrs nee GlobalSign PersonalSign 1 1841 1 to 3 yrs pickupPassword GlobalSign PersonalSign 2 1843 1 to 3 yrs pickupPassword GlobalSign PersonalSign 2 Pro 1844 1 to 3 yrs pickupPassword GlobalSign PersonalSign 2 Department 1845 1 to 3 yrs pickupPassword GlobalSign CodeSigning Organizations 1850 1 to 3 yrs pickupPassword GlobalSign CodeSigning Individual 1851 1 to 3 yrs pickupPassword 8.1.5Client certificaten verplichte velden (GlobalSign) Voor de meeste client certificaten dient u verschillende velden in te vullen bij de aanvraag. ProductCode Certifica commo at type nName email titel organis organiza locality provinci atie tionUnit e land 1841 - - x - - - - - - 1843 - x x - - - - - x 1844 - x x ? x - x x x 1845 - x x ? x - x x x 1850 x x x - x ? x x x 1851 x x x ? - - x x x 8.2 Productcodes domeinnamen (Hosting) Hieronder ziet u een overzicht van onze hostingpakketten. Aan de hand van de getProduct (sectie 3.11) kunt u meer informatie over de geselecteerde producten krijgen. U kunt echter ook naar de website van Networking4all gaan (https://www.networking4all.com/nl/hosting/). Daar vindt u meer over het product en de prijzen. Brand Hosting Productcode Networking4all Lite 1 710 Networking4all Lite 2 720 Networking4all Basic 1 500 Networking4all Basic 2 510 Networking4all Basic 3 520 Networking4all Pro 1 650 © 2013 Networking4all - www.networking4all.com pagina 92 van 99 Networking4all Pro 2 655 Networking4all Pro 3 660 Networking4all Pro 4 670 Networking4all E-mail 1 810 Networking4all E-mail 2 820 Networking4all E-mail 3 830 8.3Status codes 8.3.1Relevante status codes bij een SSL Certificaat bestelling Een lijst met relevante SSL Certificaat status codes welke als respons worden teruggegeven door de getSSLCertificateOrder functie. Met deze functie kunt u de status opvragen van de bestelling van een SSL Certificaat en indien de status code 216 is, kan via deze functie het certificaat worden opgehaald. Zie sectie 3.16 voor meer informatie. Code Beschrijving 214 SSL request niet goedgekeurd. 215 SSL Certifficaat aangevraagd. 216 SSL Certificaat uitgegeven. 218 SSL Certificaat replacement aangevraagd. 221 SSL Certifficaat verlopen. 222 SSL Certificaat bijna verlopen. 225 SSL Certificaat terugbetaald. 8.3.2Substatus codes voorSSL Certificaat aanvragen Een lijst met relavante statuscodes welke u te zien krijgt bij de getSSLCertificate en getSSLCertificateList functies. Code Beschrijving 99 Bericht 100 Approver e-mail 101 Approver e-mail nog niet goedgekeurd 102 Approver e-mail goedgekeurd 109 CSR details komen niet overeen met de bedrijfsgegevens in het handelsregister 110 Controleer de kvK 111 Bedrijfsinformatie afgekeurd, meer informatie noodzakelijk 112 Bedrijfsinformatie goedgekeurd 210 Controleer domeinnaamhouder in WHOIS 211 Gegevens eigenaar afgekeurd, meer informatie noodzakelijk 212 Gegevens eigenaar goedgekeurd 310 Controleer administratief contactpersoon 311 Administratief contactpersoon afgekeurd, meer informatie noodzakelijk © 2013 Networking4all - www.networking4all.com pagina 93 van 99 312 Administratief contactpersoon goedgekeurd 410 Contract CA naar vetting@networking4all.com gestuurd 411 Contract ongeldig, dient aangepast te worden 412 Contract goedgekeurd 510 Telefonische validatie 511 Controleer telefoonnummer bij algemene bron 512 Telefonische validatie met humane bron succesvol 513 Telefonische validatie met humane bron niet succesvol 514 Telefonische validatie met management succesvol 515 Telefonische validatie met management niet succesvol 516 Telefonische validatie met administratief contact succesvol 517 Telefonische validatie met administratief contact niet succesvol 1000 Inzage bestelling 1001 Inzage bestelling in behandeling 1002 Certificaat zal worden uitgegeven 1010 Bestelling geannuleerd door klant 1015 Bestelling geannuleerd door Certificate Authority 8.3.3Status codes voor controleren domeinnamen Een lijst met relevante status codes welke terugkomen bij de checkDomain functie. Deze handeling geeft u de mogelijkheid om één of meerdere domeinnamen te controleren voor de registratie. Zie paragraaf 3.18 voor meer informatie. Code Omschrijving 100 Beschikbaar 110 Geregistreerd 120 Uitgezonderd 130 Onbekend 140 Uitgesloten (locked) 150 Fout 160 Gereserveerd 170 Aangevraagd 180 Quarantaine 190 Illegale karakters 200 Illegaal Formaat 210 Te kort 220 Te lang 230 Streepjes aan begin en einde 240 Aan elkaar gesloten streepjes 250 Voeg meer letters toe 260 Ongeldige TLD © 2013 Networking4all - www.networking4all.com pagina 94 van 99 8.3.4Relevante status codes bij een Domeinnaam bestelling Een lijst met relevante SSL Certificaat status codes welke als respons worden teruggegeven door de getDomainOrder functie. Code Description 5 Wachten op betaling 6 Afwachting transfer 7 Afwachting trade 8 Afwachting registration 10 Actief 20 Geblokeerd, niet betaald 30 Gedeactiveerd 70 Registratie fout 80 Verhuizing aangevraagd 85 Verhuisd 90 Opzeggen aangevraagd 91 Geen vernieuwing 95 Opgezegd 8.4Extra Services Extra Services zijn functies welke beschikbaar zijn voor sommige producten, zoals malware scan. 8.4.1Malware scan Malware scan geeft u de mogelijkheid voor een dagelijkse scan van uw website, welke beveiligd is aan de hand van één van onderstaande producten: 1.Symantec Secure Site (1750) 2.Symantec Secure Site Pro (1760) 3.Symantec Secure Site With EV (1770) 4.Symantec Secure Site Pro With EV (1780) Wanneer u een certificaat besteld aan de hand van de orderSSLCertificate functie met één van bovenstaande certificaten, dan kunt u kiezen uit drie verschillende mogelijkheden (zie begin volgende pagina voor opsomming). Zo kunt u kiezen uit de malware scan en seal-in-search. Standaard staan deze functies aan. U krijgt deze optie bij de aanvraag van het certificaat, maar u kunt dit ook later nog aanpassen. Wanneer uw bestelling afgerond is (status 216) kunt u de updateSSLCertificate functie gebruiken om uw malware scan instellingen te wijzigen: U heeft drie opties: 1.Alle services aanzetten (malware scan en seal-in-search). Dit is de standaard waarde. (MS_ENABLED of niet nader gespecificeerd) 2.Alleen de malware scan aanzetten. (MS_SIS_DISABLED) © 2013 Networking4all - www.networking4all.com pagina 95 van 99 3.Zowel de malware scan als de seal-in-search functie uitzetten. (MS_DISABLED). In de orderSSLCertificate functie vindt u een nieuw veld waarin u deze opties nader kunt specificeren. Meer opties volgens mogelijk later. De opties kunnen worden gescheiden aan de hand van een komma. Zie voor meer informatie sectie 5.3 <extraPreferences> Wanneer u uw malware scan instellingen wilt wijzigen dient u de updateSSLCertificate functie te gebruiken. U heeft daarvoor uw traceNumber en onderstaande informatie nodig. Zie voor meer informatie sectie 5.10 en 7.5.13. <action rel="nofollow"> <extraPreferences> Het veld waarin u uw malware scan opties wijzigt dient het volgende te bevatten: UPDATE_EXTRA_PREFERENCES Dezelfde info als hierboven is ook noodzakelijk voor het extraPreferences veld. On-Demand-Scan Een andere mogelijkheid is het aanvragen van een On-Demand-Scan. Dit doet u meestal in het geval nadat u malware infecties heeft verwijderd en een re-scan van uw site wilt uitvoeren. Dit kunt u ook doen aan de hand van de updateSSLCertificate functie. Het veld waarin u een On-Demand-Scan aanvraagt dient het volgende te bevatten: REQUEST_ON_DEMAND_SCAN. Meer informatie is niet noodzakelijk, behalve het traceNumber. Wanneer u uw malware scan resultaten wilt inzien dient u de huidige getSSLCertificate en getSSLCertificateList functies te gebruiken. Hier is een extraServices gedeelte toegevoegd, enkel weergegeven bij certificaten welke malware scan ondersteunen. Verder zijn geen veranderingen aangebracht. Zie voor meer informatie secties 5.7 en 5.8. Meer informatie Meer informatie over de malware scan valt buiten de omvang van dit document, maar is te vinden op onze website. © 2013 Networking4all - www.networking4all.com pagina 96 van 99 9 Het API control panel Via onze website op www.networking4all.com bieden wij onze klanten een API control panel. Dit control panel laat alle requests zien die u via de API heeft ingediend en toont ook de reponses. Op deze manier heeft u een duidelijk overzicht van alle API aanvragen en resultaten. Het API control panel is te vinden onder het API tabblad wanneer u bent ingelogd op uw account. Door op het API tabblad te klikken krijgt u de overzichtspagina te zien. 9.1Overzichtsscherm U krijgt onderstaand overzichtsscherm te zien nadat u op het API tabblad hebt geklikt. In dit overzicht ziet u al uw requests gesorteerd op datum, de laatste bovenaan. U kunt ook op andere criteria sorteren zoals op functie, handle, gebruikersnaam, host, resultaat en tijdsduur. Door de filters toe te passen aan de bovenkant, ziet u alleen de relevante gegevens. U zet deze filters weer terug op default door op de naam van het betreffende filter te klikken. U kunt ook nog het aantal requests per pagina aanpassen. Requests die een foutmelding bevatten worden getoond in rood (resultCode 2) zoals in het voorbeeld hierboven, requests zonder fouten maar zonder resultaat worden getoond in blauw (resultCode 1). Alle overige requests staan in standaard tekstkleur. Door te klikken op de handle of de gebruikersnaam, gaat u direct naar deze relaties in ons systeem. Door op de datum te klikken of het detail icoon (vergrootglas) komt u in het detailscherm. © 2013 Networking4all - www.networking4all.com pagina 97 van 99 De getoonde tijd is de tijd uitgedrukt in de seconden die nodig waren om het request te verwerken. De meeste requests nemen minder dan een seconde in beslag. Er zijn echter operaties zoals checkSSLCertificateCSR, getSSLCertificateApproverList, orderSSLCertificate, resendEmailSSLCertificate en replaceSSLCertificate die meerdere seconden kunnen duren omdat wij op onze beurt de API van de Certificaat Autoriteit (CA) moeten raadplegen alvorens met een resultaat te komen. 9.2Detailscherm Het detailscherm toont alle details van uw request en de response van de API. Zowel request als response worden beiden getoond in een XML structuur, zoals die tevens gebruikt wordt in deze documentatie, zie sectie 3. Uit veiligheidsoverweging laten we hier bij de Request en Response geen wachtwoorden zien. Alle informatie omtrent uw request en de API response wordt hier getoond, alsook de informatie uit het overzicht. Dit detailscherm kan u helpen uw API processen te analyseren in het geval er mogelijk iets mis is gegaan. © 2013 Networking4all - www.networking4all.com pagina 98 van 99 Voor de meest gestelde vragen kunt u terecht op onze website http://www.networking4all.com/nl/resellers/veelgestelde+vragen/api/ T: +31 (0)20 7881030 (tel) F: +31 (0)20 7881040 (fax) E: info@networking4all.com Postbus 15320, 1001 MH Amsterdam, The Netherlands © 2013 Networking4all - www.networking4all.com pagina 99 van 99 </div> </div> </div> </div> </div> </div> </div> </div> <div class="modal fade" id="report" tabindex="-1" role="dialog" aria-hidden="true"> <div class="modal-dialog"> <div class="modal-content"> <form role="form" method="post" action="https://adoc.pub/report/1-overzicht-11-versie-opmerkingen-2-principe-van-de-api" style="border: none;"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button> <h4 class="modal-title">Report "1 Overzicht. 1.1 Versie opmerkingen. 2 Principe van de API"</h4> </div> <div class="modal-body"> <div class="form-group"> <label>Your name</label> <input type="text" name="name" required="required" class="form-control" /> </div> <div class="form-group"> <label>Email</label> <input type="email" name="email" required="required" class="form-control" /> </div> <div class="form-group"> <label>Reason</label> <select name="reason" required="required" class="form-control"> <option value="">-Select Reason-</option> <option value="pornographic" selected="selected">Pornographic</option> <option value="defamatory">Defamatory</option> <option value="illegal">Illegal/Unlawful</option> <option value="spam">Spam</option> <option value="others">Other Terms Of Service Violation</option> <option value="copyright">File a copyright complaint</option> </select> </div> <div class="form-group"> <label>Description</label> <textarea name="description" required="required" rows="3" class="form-control" style="border: 1px solid #cccccc;"></textarea> </div> <div class="form-group"> <div style="display: inline-block;"> <div class="g-recaptcha" data-sitekey="6LcEnMcZAAAAAFHzKKgaE-Qh57XzUTzpfRElD4dP"></div> </div> </div> <script src='https://www.google.com/recaptcha/api.js'></script> </div> <div class="modal-footer"> <button type="button" class="btn btn-default" data-dismiss="modal">Close</button> <button type="submit" class="btn btn-primary">Send</button> </div> </form> </div> </div> </div> <script> $(document).ready(function () { var inner_height = $(window).innerHeight() - 250; $('#pdfviewer').css({"height": inner_height + "px"}); }); </script> <footer class="footer" style="margin-top: 60px;"> <div class="container-fluid"> Copyright © 2024 ADOC.PUB. All rights reserved. <div class="pull-right"> <a href="https://adoc.pub/about">About Us</a> | <a href="https://adoc.pub/privacy">Privacy Policy</a> | <a href="https://adoc.pub/term">Terms of Service</a> | <a href="https://adoc.pub/copyright">Copyright</a> | <a href="https://adoc.pub/contact">Contact Us</a> | <a href="https://adoc.pub/cookie_policy">Cookie Policy</a> </div> </div> </footer>  <div class="modal fade" id="login" tabindex="-1" role="dialog" aria-labelledby="myModalLabel"> <div class="modal-dialog" role="document"> <div class="modal-content"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal" aria-label="Close" on="tap:login.close">×</button> <h4 class="modal-title" id="add-note-label">Sign In</h4> </div> <div class="modal-body"> <form action="https://adoc.pub/login" method="post"> <div class="form-group"> <label class="sr-only" for="email">Email</label> <input class="form-input form-control" type="text" name="email" id="email" value="" placeholder="Email" /> </div> <div class="form-group"> <label class="sr-only" for="password">Password</label> <input class="form-input form-control" type="password" name="password" id="password" value="" placeholder="Password" /> </div> <div class="form-group"> <div class="checkbox"> <label class="form-checkbox"> <input type="checkbox" name="remember" value="1" /> Remember me </label> <label class="pull-right"><a href="https://adoc.pub/forgot">Forgot password?</a></label> </div> </div> <button class="btn btn-primary btn-block" type="submit">Sign In</button> </form> </div> </div> </div> </div>  <script async src="https://www.googletagmanager.com/gtag/js?id=UA-177279549-1"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-177279549-1'); </script> <script src="https://adoc.pub/assets/js/jquery-ui.min.js"></script> <link rel="stylesheet" href="https://adoc.pub/assets/css/jquery-ui.css"> <script> $(function () { $("#document_search").autocomplete({ source: function (request, response) { $.ajax({ url: "https://adoc.pub/suggest", dataType: "json", data: { term: request.term }, success: function (data) { response(data); } }); }, autoFill: true, select: function( event, ui ) { $(this).val(ui.item.value); $(this).parents("form").submit(); } }); }); </script>  <div id="ADOCPUB_cookie_box" style="z-index:99999; border-top: 1px solid #fefefe; background: #FFC107; width: 100%; position: fixed; padding: 5px 15px; text-align: center; left:0; bottom: 0;"> Our partners will collect data and use cookies for ad personalization and measurement. <a href="https://adoc.pub/cookie_policy" target="_blank">Learn how we and our ad partner Google, collect and use data</a>. <a href="#" class="btn btn-success" onclick="accept_ADOCPUB_cookie_box();return false;">Agree & close</a> </div> <script> function accept_ADOCPUB_cookie_box() { document.cookie = "ADOCPUB_cookie_box_viewed=1;max-age=15768000;path=/"; hide_ADOCPUB_cookie_box(); } function hide_ADOCPUB_cookie_box() { var cb = document.getElementById('ADOCPUB_cookie_box'); if (cb) { cb.parentElement.removeChild(cb); } } (function () { var ADOCPUB_cookie_box_viewed = (function (name) { var matches = document.cookie.match(new RegExp("(?:^|; )" + name.replace(/([\.$?*|{}\[\]\\\/\+^])/g, '\\$1') + "=([^;]*)")); return matches ? decodeURIComponent(matches[1]) : undefined; })('ADOCPUB_cookie_box_viewed'); if (ADOCPUB_cookie_box_viewed) { hide_ADOCPUB_cookie_box(); } })(); </script>  </body> </html>

1 Overzicht. 1.1 Versie opmerkingen. 2 Principe van de API

Recommend Documents