API-documentatie: Domains Module

Dit artikel beschrijft alle beschikbare acties binnen de domains-module van de xYnta API. Per actie staan de benodigde parameters en de mogelijke statuswaardes in de response.

Inhoudsopgave

Domeinacties

• check — Beschikbaarheid controleren
• list — Domeinoverzicht ophalen
• order — Domein bestellen of verhuizen
• show — Domeindetails opvragen
• del — Domein opzeggen
• edit-contact — WHOIS-gegevens wijzigen
• edit-nameserver — Nameservers wijzigen
• lock — Domein vergrendelen
• unlock — Domein ontgrendelen
• get-authkey — Verhuiscode opvragen

Contactacties

• list, t: contact — Contacten-overzicht
• show, t: contact — Contactgegevens bekijken
• add, t: contact — Contact toevoegen
• edit, t: contact — Contact wijzigen
• check, t: contact — Contact controleren
• del, t: contact — Contact verwijderen

DNS-acties

• show-dns-zone — DNS-zone bekijken
• edit-dns-zone — DNS-zone bewerken

check — Beschikbaarheid controleren

m: domains, a: check

Controleert of een domeinnaam beschikbaar is voor registratie.

Statuswaardes:

• available — de domeinnaam is beschikbaar.
• unavailable — de domeinnaam is al geregistreerd.

list — Domeinoverzicht ophalen

m: domains, a: list

Haalt een overzicht op van alle domeinnamen gekoppeld aan het account.

Geen parameters vereist.

Statuswaardes:

• success — het domeinoverzicht is succesvol opgehaald.

order — Domein bestellen of verhuizen

m: domains, a: order

Bestelt of verhuist een domeinnaam. Zie ook: Domeinnamen real-time bestellen via de API.

Statuswaardes:

• success — de domeinnaam is succesvol besteld.
• not-authorized — achteraf factureren is niet ingeschakeld.
• not-found-service — de extensie wordt niet ondersteund.
• not-found-contact — een of meer opgegeven contacten zijn niet gevonden.
• not-available — de domeinnaam is al eerder besteld.
• validation-domain — ongeldig formaat domeinnaam.

show — Domeindetails opvragen

m: domains, a: show

Haalt de details van een specifieke domeinnaam op.

Statuswaardes:

• success — de domeinnaam is gevonden.
• not-authorized — geen toegang tot dit domein.
• not-found — het domein bestaat niet.

del — Domein opzeggen

m: domains, a: del, t: cancel / cancel-direct / undo

Zegt een domeinnaam op. Gebruik t: cancel voor opzegging op einde contractperiode, t: cancel-direct voor directe opzegging, of t: undo om een lopende opzegging ongedaan te maken.

Statuswaardes:

• success — het domein is opgezegd.
• pending-deletion — de opzegging was al actief.
• not-supported — opzegging is niet mogelijk voor deze extensie.
• not-authorized — geen toegang tot dit domein.
• not-found — het domein bestaat niet.

edit-contact — WHOIS-gegevens wijzigen

m: domains, a: edit-contact

Wijzigt de aan een domeinnaam gekoppelde contacten (houder, administratief en technisch).

Statuswaardes:

• success — de contacten zijn gewijzigd.
• error — wijziging mislukt.
• not-authorized — geen toegang tot dit domein.
• not-found — het domein bestaat niet.

edit-nameserver — Nameservers wijzigen

m: domains, a: edit-nameserver

Wijzigt de nameservers van een domeinnaam.

Statuswaardes:

• success — de nameservers zijn gewijzigd.
• warning — de nameservers zijn niet aangepast.
• error — wijziging mislukt.
• not-authorized — geen toegang tot dit domein.
• not-found — het domein bestaat niet.

lock — Domein vergrendelen

m: domains, a: lock

Activeert een transfer lock op de domeinnaam om ongeautoriseerde verhuizing te voorkomen.

Statuswaardes:

• success — het domein is vergrendeld.
• not-supported — niet ondersteund voor deze extensie.
• not-authorized — geen toegang tot dit domein.
• not-found — het domein bestaat niet.

unlock — Domein ontgrendelen

m: domains, a: unlock

Verwijdert de transfer lock van een domeinnaam.

Statuswaardes:

• success — het domein is ontgrendeld.
• not-supported — niet ondersteund voor deze extensie.
• not-authorized — geen toegang tot dit domein.
• not-found — het domein bestaat niet.

get-authkey — Verhuiscode opvragen

m: domains, a: get-authkey

Vraagt de verhuiscode (EPP-code / authcode) op voor een domeinnaam.

Statuswaardes:

• success — de verhuiscode is opgevraagd.
• warning — er is geen verhuiscode beschikbaar.
• error — het ophalen is mislukt.
• not-supported — niet ondersteund voor deze extensie.
• not-authorized — geen toegang tot dit domein.
• not-found — het domein bestaat niet.

list, t: contact — Contacten-overzicht

m: domains, a: list, t: contact

Haalt een overzicht op van alle contacten gekoppeld aan het account.

Geen parameters vereist.

Statuswaardes:

• success — de contacten zijn opgehaald.
• pending — de verwerking is nog bezig.
• not-authorized — geen toegang.
• not-found — geen contacten gevonden.

show, t: contact — Contactgegevens bekijken

m: domains, a: show, t: contact

Haalt de details van een specifiek contact op.

Statuswaardes:

• success — het contact is gevonden.
• pending — de verwerking is nog bezig.
• not-authorized — geen toegang.
• not-found — het contact is niet gevonden.

add, t: contact — Contact toevoegen

m: domains, a: add, t: contact

Maakt een nieuw contact aan. Gebruikt dezelfde parameters als edit, t: contact.

Statuswaardes:

• success — het contact is toegevoegd.
• error-processing — het contact kon niet worden toegevoegd.
• validation-handle — ongeldige Handle.
• validation-emailaddress — ongeldig e-mailadres.
• validation-address — ongeldig adres.
• validation-phonenumber — ongeldig telefoonnummer.
• not-found — het contact is niet gevonden.

edit, t: contact — Contact wijzigen

m: domains, a: edit, t: contact

Wijzigt de gegevens van een bestaand contact.

Statuswaardes:

• success — het contact is gewijzigd.
• error-processing — wijziging mislukt.
• validation-handle — ongeldige Handle.
• validation-emailaddress — ongeldig e-mailadres.
• validation-address — ongeldig adres.
• validation-phonenumber — ongeldig telefoonnummer.
• pending-processing — verwerking loopt.
• pending-modification — contact wordt aangepast.
• pending-deletion — contact wordt verwijderd.
• not-found — het contact is niet gevonden.

check, t: contact — Contact controleren

m: domains, a: check, t: contact

Controleert of een contact al bestaat op basis van naam.

Statuswaardes:

• success — het contact bestaat.
• not-found — het contact is niet gevonden.

del, t: contact — Contact verwijderen

m: domains, a: del, t: contact

Verwijdert een bestaand contact.

Statuswaardes:

• success — het contact is verwijderd.
• pending-processing — verwerking gestart.
• pending-modification — contact in wijziging.
• pending-deletion — contact al in verwijdering.
• not-found — het contact is niet gevonden.

show-dns-zone — DNS-zone bekijken

m: domains, a: show-dns-zone

Haalt de DNS-zone van een domeinnaam op.

Statuswaardes:

• success — de DNS-zone is gevonden.
• not-found — de zone is niet gevonden.

edit-dns-zone — DNS-zone bewerken

m: domains, a: edit-dns-zone

Past de DNS-zone van een domeinnaam aan.

Statuswaardes:

• success — de DNS-zone is aangepast.
• error-processing — wijziging mislukt.
• not-found — de zone is niet gevonden.

Problemen of vragen over een specifieke call? Zie API-call troubleshooting of neem contact op.

Bijgewerkt op: 19/04/2026