DeziWeb

API

Speciaal voor de klanten die geen tijd willen kwijt zijn aan het registreren van domeinnamen heeft Deziweb een API ontwikkeld. Doormiddel van deze API is het mogelijk om uw eigen bestelsysteem te koppelen aan ons bestelsysteem zodat u nooit meer handmatig een domeinaanvraag hoeft in te dienen. Op dit moment kunt u de door Deziweb geleverde domeinextensies registreren via de API. In de toekomst zullen er nog meer functies worden toegevoegd aan de API.

Functies

De volgende functies zitten in de huidige versie (v1.0):
- Aanvragen en verhuizen van domeinnamen
- Betaling via prepaid tegoed

Systeemeisen

Uw webserver moet voorzien zijn van een werkende versie van PHP met daarin de CURL optie. Voor meer informatie over CURL kunt u kijken op http://nl.php.net/curl.

Werkwijze

Om gebruik te kunnen maken van de API dient u een online handtekening te hebben geplaatst in het bestelsysteem van Deziweb en dient u te beschikken over voldoende prepaid tegoed. Vervolgens kunt u aan de slag met het maken van uw scripts.

Deziweb biedt een PHP class aan voor eenvoudige communicatie met de API. Deze class vereist dat PHP is gecompileerd met CURL ondersteuning.

Upload de twee bestanden deziweb_api.php en deziweb_api_config.php naar uw server en edit het bestand deziweb_api_config.php waarbij u de nodige waarden invult.

U kunt nu door deze twee scripts te includen gebruik maken van de functies uit de Deziweb API. De mogelijkheden worden hieronder beschreven. Zet bovenaan uw script (let op: deze volgorde is noodzakelijk):

include("deziweb_api_config.php");
include("deziweb_api.php");

Alle Deziweb API functies beginnen met deziweb_ en geven een resultaat terug. Positieve resultaten worden teruggegeven als "OK xxx Bericht" waarbij xxx de antwoordcode is en Bericht een beschrijving. Foutieve resultaten worden teruggegeven als "ERR xxx Bericht".

De API ondersteunt een mogelijkheid om de functies te testen. U gebruikt de test mode door in het bestand deziweb_api_config.php de variabele DEZIWEB_API_TESTMODE op true te zetten. Op deze manier worden aanvragen niet door Deziweb behandeld maar krijgt u wel de return codes terug.

Domeinregistratie

Om een domein te registreren of te verhuizen via de Deziweb API heeft u slechts één functie nodig. Met de functie deziweb_registerdomain kunt u zowel een nieuwe aanvraag als een verhuizing indienen. De API bepaalt vervolgens zelf aan de hand van de beschikbaarheid van het domein of het gaat om een nieuwe aanvraag of een verhuizing.

Voorbeeld:

<?php

include ("./deziweb_api_config.php");
include ("./deziweb_api.php");

$register["domain"] = "ditwordtmijndomein";
$register["tld"] = "nl";
$register["secretCode"] = "secretcode";

$ns["ns1"] = "ns1.deziweb.com";
$ns["ns2"] = "ns2.deziweb.com";

$whois["ownerName"] = "Deziweb";
$whois["ownerStreet"] = "Straat";
$whois["ownerHousenumber"] = "1";
$whois["ownerHousenumberAddition"] = "a";
$whois["ownerPostcode"] = "1234 AB";
$whois["ownerPlace"] = "Emmen";
$whois["ownerCountry"] = "Nederland";
$whois["adminName"] = "Deziweb";
$whois["adminContactName"] = "Stegeman";
$whois["adminContactInitials"] = "M.";
$whois["adminContactGender"] = "M";
$whois["adminStreet"] = "Straat";
$whois["adminHousenumber"] = "1";
$whois["adminHousenumberAddition"] = "a";
$whois["adminPostcode"] = "1234 AB";
$whois["adminPlace"] = "Emmen";
$whois["adminCountry"] = "Nederland";
$whois["adminPhone"] = "+31-0123456789";
$whois["adminFax"] = "";
$whois["adminEmail"] = "info@deziweb.com";
$whois["techName"] = "Deziweb";
$whois["techContactName"] = "Stegeman";
$whois["techContactInitials"] = "M.";
$whois["techContactGender"] = "M";
$whois["techStreet"] = "Straat";
$whois["techHousenumber"] = "1";
$whois["techHousenumberAddition"] = "a";
$whois["techPostcode"] = "1234 AB";
$whois["techPlace"] = "Emmen";
$whois["techCountry"] = "Nederland";
$whois["techPhone"] = "+31-0123456789";
$whois["techFax"] = "";
$whois["techEmail"] = "info@deziweb.com";

$result = deziweb_registerdomain($register,$whois,$ns);

?>
Antwoord codes

Hieronder een lijst met mogelijke fout-codes:
001 Geen logininformatie opgegeven
002 Geen WHOIS-informatie opgegeven
003 Geen nameservers opgegeven
004 Onjuist login gegevens of geen digitale handtekening aanwezig
005 Er zijn minimaal 2 nameservers nodig voor een aanvraag
006 Naam van de eigenaar ontbreekt
007 Straat van de eigenaar ontbreekt
008 Huisnummer van de eigenaar ontbreekt
009 Postcode van de eigenaar ontbreekt
010 Plaats van de eigenaar ontbreekt
011 Land van de eigenaar ontbreekt
012 Naam van contactpersoon ontbreekt
013 Voorletters van contactpersoon ontbreken
014 Achternaam van contactpersoon ontbreken
015 Geslacht van contactpersoon ontbreekt
016 Straat van contactpersoon ontbreekt
017 Huisnummer van contactpersoon ontbreekt
018 Postcode van contactpersoon ontbreekt
019 Plaats van contactpersoon ontbreekt
020 Land van contactpersoon ontbreekt
021 Telefoonnummer van contactpersoon ontbreekt
022 E-mail van contactpersoon ontbreekt
023 Naam van technisch contact ontbreekt
024 Voorletters van technisch contact ontbreken
025 Achternaam van technisch contact ontbreken
026 Geslacht van technisch contact ontbreekt
027 Straat van technisch contact ontbreekt
028 Huisnummer van technisch contact ontbreekt
029 Postcode van technisch contact ontbreekt
030 Plaats van technisch contact ontbreekt
031 Land van technisch contact ontbreekt
032 Telefoonnummer van technisch contact ontbreekt
033 E-mail van technisch contact ontbreekt
034 Huisnummer van eigenaar bevat onjuiste tekens
035 Huisnummer van contactpersoon bevat onjuiste tekens
036 Huisnummer van technisch contact bevat onjuiste tekens
037 Telefoonnummer van contactpersoon in onjuist formaat
038 Telefoonnummer van technisch contact in onjuist formaat
039 Geslacht van contactpersoon is M of V
040 Geslacht van technisch contact is M of V
041 Nameservers mogen niet hetzelfde IP-adres hebben
042 Geen domeinnaam opgegeven
043 Geen TLD voor domein opgegeven
044 Deze TLD wordt niet door Deziweb ondersteund
045 Account geblokkeerd om administratie redenen
046 Niet voldoende tegoed voor deze bestelling

» Download API

Is uw domeinnaam nog vrij?