Domeinregistratie
Registrar-operaties — TLD-registraties registreren, verhuizen en beheren, samen met hun contacten. Dit is iets anders dan Domeinen, dat de hostnames beheert die aan WordPress-sites zijn gekoppeld.
Feature-flagged
Deze endpoints worden afgeschermd door de domain-registration feature
flag. Wanneer die uitstaat, retourneert elk endpoint hier 503
{"errors":[...],"code":"feature_disabled"}.
Account-scope vereist (X-Auth-Account) — een ontbrekende header retourneert
400. OAuth-scopes: lezen domains:read, schrijven domains:write.
Mutaties vereisen de can_edit-rol. Mutaties kunnen synchroon worden
afgerond (200) of een asynchroon registrar-proces openen
(202 met pending_process). TLD's zonder geconfigureerde registrar
retourneren 503 registrar_unavailable; upstream registrar-fouten
retourneren 502.
409 registration_busy beschermt niet elke mutatie
Zolang een registratie een lopend registrarproces heeft, worden deze acties
afgewezen met 409 registration_busy: update, nameservers, lock, privacy,
dnssec, holder, contacts, push_transfer en registrant_change.
force_sync, transfer_out, resend_contact_verification, renew_now en
de endpoints resend / cancel voor processen lopen wél door.
422 domain_import_held: geblokkeerde registraties zijn alleen-lezen
Zolang een registratie geblokkeerd is, wordt elke wijziging eraan, en aan een
contact dat ze gebruikt, afgewezen met 422 domain_import_held totdat de
blokkade is opgeheven. Lezen blijft werken, behalve het opvragen van de EPP-code.
Een domein registreren/verhuizen is een bestelling
De endpoints hier controleren beschikbaarheid (check /
suggesties) en beheren bestaande registraties.
Om daadwerkelijk een domein te registreren of te verhuizen, plaats je
een betaalde bestelling via POST /api/orders/domain (zie het
volledige paramoverzicht in Bestellingen). Om de houder van een
registratie te wijzigen als betaalde bestelling, gebruik je
POST /api/domain_registrations/:id/registrant_change
(de factureerbare tegenhanger van PATCH .../holder).
Domeincontacten
Herbruikbare contacten voor houder/admin/tech/facturatie die domeinregistraties
ondersteunen. Een contact wordt bij het aanmaken aan één TLD vastgepind omdat
elke registry een andere set velden valideert. :id is het numerieke contact-ID.
Vorm van een domeincontact
- id: Integer
- handle: String
- first_name: String
- last_name: String
- organization: String
- street_address: String
- post_code: String
- city: String
- state: String
- country: String | ISO-2
- email: String
- phone: String | E.164,
+CC.NUMBER - extra_properties: Object | TLD-specifieke registry-velden
- validations: Array
- split_from_id: Integer | null
- created_at: DateTime
- updated_at: DateTime
Domeincontacten weergeven
GET /api/domain_contacts
Params (optioneel)
- q: String | substring-match tegen handle, organisatie, volledige naam of registratienaam
Retourneert { "domain_contacts": [ ... ] }.
Een domeincontact bekijken
GET /api/domain_contacts/:id
Een domeincontact aanmaken
POST /api/domain_contacts
Maakt het contact aan bij de registrar ÉN lokaal. Retourneert 201. Je moet
tld_id of tld_name meegeven zodat de juiste registry-regels van toepassing
zijn. Een onbekende TLD retourneert 404 tld_not_found.
Params
- tld_id: Integer | één van tld_id / tld_name vereist
- tld_name: String | bijv. ".uk", ".com"
- domain_contact: Object (vereist)
- first_name, last_name, organization, street_address, post_code, city, state: String | minstens één van
first_name/last_nameis vereist - country: String | ISO-2
- email: String
- phone: String | E.164 (
+CC.NUMBER). Een nationaal nummer zoals0612345678wordt omgezet aan de hand vancountry; een nummer dat niet herkend wordt, wordt afgewezen - extra_properties: Object | TLD-specifieke registry-velden
- first_name, last_name, organization, street_address, post_code, city, state: String | minstens één van
Een domeincontact bijwerken
PATCH /api/domain_contacts/:id
Retourneert 200, of 202 met pending_process wanneer de registry de update
asynchroon verwerkt. Als een momenteel gekoppeld domein de wijziging afwijst,
wordt het contact transparant gesplitst (het origineel houdt de mislukkende
domeinen, voor de rest wordt een nieuw contact aangemaakt). Geef tld_id/tld_name
mee om te bepalen welke TLD-validatieregels van toepassing zijn (standaard de TLD
van de eerste gekoppelde registratie).
Params
- tld_id | tld_name: zie aanmaken
- domain_contact: Object | dezelfde velden als bij aanmaken (allemaal optioneel)
Fouten
- 422
domain_import_held| een registratie die dit contact gebruikt is geblokkeerd
Een domeincontact verwijderen
DELETE /api/domain_contacts/:id
Alleen toegestaan wanneer geen enkele registratie dit contact gebruikt.
Retourneert 204.
Fouten
- 422
contact_in_use| nog gekoppeld aan een registratie - 422
tld_required_for_orphan| verweesd contact + geen tld_id/tld_name opgegeven
Verificatie-e-mail opnieuw verzenden
POST /api/domain_contacts/:id/resend_verification
Voor contacten op TLD's die houdervalidatie vereisen (.au, .it, …). Retourneert
{ "status": "queued" }.
Fouten
- 422
domain_import_held| een registratie die dit contact gebruikt is geblokkeerd
Domeinregistraties
:id is de registratie-guid.
Vorm van een domeinregistratie
- id: String | guid
- name: String
- status: String
- expires_at: DateTime
- auto_renew: Boolean
- locked: Boolean
- privacy_protect: Boolean
- dnssec_enabled: Boolean
- server_transfer_prohibited: Boolean
- local_contact_active: Boolean
- cancellation_deadline_at: DateTime | indien van toepassing
- within_cancellation_window: Boolean | indien van toepassing
- opt_out_deadline_at: DateTime | null | de deadline om auto-renew uit te schakelen met restitutie of tegoed voor de komende termijn. Gelijk aan
cancellation_deadline_at, behalve voor sommige domeinen: uitschakelen daarna (toegestaan totcancellation_deadline_at) restitueert niets - renewal_invoice_on: Date | null | de dag waarop de verlenging van deze cyclus wordt gefactureerd;
nullzonder vervaldatum of facturatieplan - auto_renew_enable_blocked: Boolean |
truewanneer inschakelen van auto-renew wordt geweigerd metrenewal_due; gebruik dan Nu verlengen - renew_now_available: Boolean |
truewanneerPOST .../renew_noween te betalen factuur kan teruggeven - nameservers:
Array<String> - tld: Object | { id, name, registrar }
- owner_contact / admin_contact / tech_contact / billing_contact: Object | zie vorm van een domeincontact, of null
- pending_async: Boolean
- rtr_process_id: String
- rtr_process_status: String
- transfer_out_pending: Boolean
- push_transfer_pending: Boolean
- subscription_id: String
- feature_flags: Object | { supports_privacy, supports_transfer_lock, supports_push_transfer, supports_dnssec, requires_contact_validation, authcode_behavior }
- fees: Object | { privacy_enable, registrant_change } — elk
{ amount_cents, currency }of null. Alleen geprijsd op weergeven en bekijken; elk ander antwoord dat een registratie teruggeeft, rapporteert beide alsnull, ongeacht de werkelijke kosten van de TLD - created_at: DateTime
- updated_at: DateTime
Elk endpoint dat een registratie teruggeeft, rendert dezelfde envelope. Zolang
een registrarproces loopt (pending_async is true) draagt die envelope ook een
pending_process-object — bij de 202 die het proces opent, en bij elk later
antwoord totdat het proces klaar is. De rest van de tijd wordt het volledig
weggelaten.
Vorm van pending_process
- id: String | de identifier van het registrarproces — dezelfde waarde als
rtr_process_id - action: String | null | het registrar-commando dat het proces heeft geopend, bijv.
PushTransfer,UpdateContactCommand;nullwanneer het endpoint geen label heeft meegegeven - status: String | de processtatus van de registrar, of
pendingzolang er nog geen is gerapporteerd — dezelfde waarde alsrtr_process_status - poll_url: String | relatief pad (geen absolute URL) naar het proces van deze registratie, bijv.
/api/domain_registrations/{id}/processes/{process-id}— dit is wat een202-aanroeper pollt; zie Een proces ophalen
Domeinregistraties weergeven
GET /api/domain_registrations
Params (optioneel)
- q: String | hoofdletterongevoelige substring-match tegen
name
Retourneert { "domain_registrations": [ ... ] }.
Een domeinregistratie bekijken
GET /api/domain_registrations/:id
Voegt, indien van toepassing, toe. dns_zone, linked_site en transfer_out
worden volledig uit de JSON weggelaten wanneer ze niet van toepassing zijn —
ze komen nooit terug als null, dus controleer op de aanwezigheid van de
sleutel in plaats van op een null-waarde:
Geretourneerde params
- domain_registration: Object | zie vorm hierboven
- dns_zone: Object | { id, name } — alleen wanneer het account een DnsZone heeft voor deze naam
- linked_site: Object | { id, name } — alleen wanneer een Site deze naam als hostname gebruikt
- transfer_out: Object | live registry-weergave, alleen terwijl
transfer_out_pendingtrue is
Beschikbaarheid controleren
POST /api/domain_registrations/check
Params
- domain: String (vereist) | volledig gekwalificeerd, bijv. "example.com"
Geretourneerde params
- domain: String | genormaliseerde lookup
- available: Boolean | alleen true wanneer de registry zegt dat het beschikbaar is ÉN er een registratieprijs bestaat voor dit account — een naam die de registry wel zou verkopen komt dus alsnog terug als
falsewanneer wij er geen prijs voor hebben - premium: Boolean
- owned_by_account: Boolean
- reason: String | null | door de registrar opgegeven reden wanneer niet beschikbaar
- price: Object | null |
{ amount_cents, currency }— huidige bestelbare registratieprijs - transfer_price: Object | null |
{ amount_cents, currency }— huidige bestelbare inkomende verhuisprijs
Het veld voor de registratieprijs heet price, niet create_price
De registratieprijs komt terug als price; alleen de verhuisprijs houdt het
achtervoegsel _price. Beide sleutels zijn altijd aanwezig; beide kunnen
null zijn wanneer er geen prijs is voor het plan van dit account.
Fouten
- 422
missing_domain/invalid_domain/unknown_tld - 502
request_failed| de lookup bij de registrar is mislukt of gaf een fout. Dit endpoint gebruikt geenregistrar_unavailable: elk foutpad hier draagt zijn eigen code, dusrequest_failedis de enige502-code die het uitstuurt
Domeinsuggesties
POST /api/domain_registrations/suggestions
Params
- domain: String (vereist) | basisnaam of volledig gekwalificeerd
Geretourneerde params
- domain: String | genormaliseerde lookup
- suggestions:
Array<Object>- domain: String
- tld: String
- source: String | ADAC-categorisatie (bijv. "spinner", "premium")
- available: Boolean
- price: Object |
{ amount_cents, currency }
Fouten
- 422
missing_domain - 503
missing_api_key - 502
registrar_unavailable
Een registratie bijwerken
PATCH /api/domain_registrations/:id
Op dit moment is auto_renew het enige ondersteunde veld.
- Uitschakelen vóór de registry-deadline (of, waar die afwijkt, vóór
opt_out_deadline_at) restitueert geld dat al is gefactureerd voor het komende jaar (betaalde factuur) of verrekent het als tegoed (onbetaalde factuur).settlementtoont hoe ver dat staat. - Weer inschakelen voordat er geld is verplaatst, annuleert die restitutie
(
settlement.statusiscanceled_by_enable) en de verlengfactuur blijft staan. Daarna wordt het geweigerd; gebruik Nu verlengen.
Params
- domain_registration: Object
- auto_renew: Boolean
Geretourneerde params
- domain_registration: Object | ververst
- scenario: String |
enabled,clean_cancel,refund_cancel, oflate_cancel - settlement: Object | null | de restitutie voor het uitschakelen van auto-renew. Altijd aanwezig bij een
auto_renew-update (nullwanneer er geen is)- status: String | bijvoorbeeld
pending,admin_review,approved,failed,missed,settled. Na een inschakeling die de restitutie annuleerde, is het object alleen{ status: "canceled_by_enable" } - refund: String |
refunded,credited,voided,pending,under_reviewofnone - refund_cents: Integer | afgerekend bedrag, of de schatting zolang de verrekening open is
- credit_cents: Integer | afgerekend bedrag, of de schatting zolang de verrekening open is
- currency: String | null | ISO 4217, kleine letters
- waiting: String | null |
payment(een bankincasso is nog in behandeling),finalize(de verlengfactuur wordt nog uitgegeven) ofnull
- status: String | bijvoorbeeld
Fouten
- 422
invalid_param|auto_renewis meegestuurd maar is geen boolean - 422
cancellation_window_passed| kan auto-renew niet uitschakelen zodra de registry-deadline is verstreken - 422
auto_renew_settlement_in_progress| een restitutie voor deze verlenging wordt verwerkt; probeer het opnieuw zodra die klaar is - 422
renew_now_payment_processing| een Nu-verlengen-betaling is nog in behandeling; probeer het opnieuw zodra die is afgerond - 422
renewal_due| deze verlenging is achterstallig; gebruik Nu verlengen - 422
renewal_price_missing| er is geen verlengprijs geconfigureerd voor dit domein - 422
auto_renew_dunning_locked| een onbetaalde factuur houdt auto-renew uitgeschakeld - 422
auto_renew_bridged_term_credited| de huidige termijn is al gerestitueerd of als tegoed verrekend; de facturatie hervat op de factuurdatum van de volgende termijn - 422
auto_renew_import_charge_pending/auto_renew_import_charge_dropped| de eenmalige afschrijving van het domein is onvoltooid of vervallen; probeer het opnieuw na de datum in het bericht - 422
auto_renew_update_failed| elke andere fout - 400
no_op| geen ondersteunde velden in de update
Een domein nu verlengen
POST /api/domain_registrations/:id/renew_now
Geeft een te betalen factuur terug voor de huidige verlenging van het domein,
wanneer renew_now_available true is op de registratie. Het domein wordt bij de
registry verlengd zodra de factuur is betaald. Opnieuw aanroepen geeft dezelfde
openstaande factuur terug. Vereist
domains:write en de can_edit-rol; wordt niet beschermd door
409 registration_busy.
Geretourneerde params
- payable_url: String | gehoste factuurpagina waar de klant betaalt
- invoice_id: String | null | het id van de factuur bij onze betalingsprovider
Fouten
- 422
recovery_wrong_phase| Nu verlengen is op dit moment niet beschikbaar voor dit domein - 422
renewal_term_cap| een registratie kan maximaal 10 jaar vooruit lopen - 422
recovery_payment_received| de openstaande factuur is al betaald en de verlenging wordt verwerkt - 422
renewal_payment_processing| een betaling van de openstaande verlengfactuur van dit domein is nog in behandeling (bijvoorbeeld een SEPA-incasso). Probeer het opnieuw zodra die is afgerond of mislukt - 422
renew_now_failed| de factuur kon niet worden aangemaakt - 422
domain_import_held| de registratie is geblokkeerd
Nameservers bijwerken
PATCH /api/domain_registrations/:id/nameservers
Params
- nameservers:
Array<String>(vereist)
Retourneert 200 of 202 (met pending_process).
Fouten
- 422
nameservers_required| de lijst is leeg / allemaal blanco
Verhuisslot in-/uitschakelen
PATCH /api/domain_registrations/:id/lock
Schakelt CLIENT_TRANSFER_PROHIBITED bij de registry in of uit.
Params
- locked: Boolean (vereist)
Fouten
- 422
invalid_param|lockedontbreekt of is geen boolean - 422
lock_unsupported| TLD ondersteunt geen verhuisslot - 422
server_transfer_prohibited| registry heeft verhuizingen verboden
WHOIS-privacy in-/uitschakelen
PATCH /api/domain_registrations/:id/privacy
Params
- privacy_protect: Boolean (vereist)
Privacy uitschakelen is altijd gratis. Inschakelen op een betaalde TLD
retourneert 402:
Reactie met kosten (402 Payment Required)
- errors: Array
- code: String |
payment_required - price: Object | { amount_cents, currency, role: "privacy" }
- portal_url: String
- remediation: String
Fouten
- 422
invalid_param|privacy_protectontbreekt of is geen boolean - 422
privacy_unsupported| TLD ondersteunt geen WHOIS-privacy
DNSSEC beheren
PATCH /api/domain_registrations/:id/dnssec
Params
- mode: String (vereist) |
enable,disable, ofadd_keys - key_data:
Array<Object>| vereist voor enable / add_keys- flags: Integer
- algorithm: Integer
- publicKey: String | base64
Fouten
- 422
invalid_mode| mode ontbreekt of onbekend - 422
dnssec_no_keys| enable/add_keys aangeroepen zonder key_data
Houder (registrant) wijzigen
PATCH /api/domain_registrations/:id/holder
Bewerk het bestaande houdercontact ter plekke, of vervang het.
Params
- holder_contact: Object (vereist)
- action_mode: String |
edit_currentofchange - first_name, last_name, organization, street_address, post_code, city, state: String
- country: String | ISO-2
- email: String
- phone: String | E.164
- extra_properties: Object
- confirm_reverification: "1" | vereist wanneer bewerkingen een gevalideerd veld raken
- action_mode: String |
- source_domain_contact_id: Integer | met
change, hergebruik dit bestaande contact - new_contact: Object | met
change, maak een nieuw contact aan
De kostenpoort gaat alleen af bij action_mode: change op een betaalde TLD
(retourneert 402 payment_required met een price-blok waarvan de role
gelijk is aan registrant_change + portal_url); edit_current-bewerkingen
zijn altijd gratis. Om de factureerbare wijziging direct uit te voeren (in plaats
van naar het portaal te worden gestuurd), gebruik je
POST .../registrant_change.
Fouten
- 402
payment_required|action_mode: changeop een TLD die houderwijzigingen factureert (prijsrole: "registrant_change", kostenblok +portal_url) - 409
reverification_required| gevalideerde velden gewijzigd zonderconfirm_reverification: "1" - 404
source_contact_not_found|source_domain_contact_idniet gevonden of niet gebruikt in dit account
Een houderwijziging (registrant) bestellen
POST /api/domain_registrations/:id/registrant_change
Plaatst een betaalde bestelling om de houder (eigenaar) van de registratie te
wijzigen — voor TLD's die houderwijzigingen factureren (bijv. .com / .net via
Verisign IRTP). Dit is de factureerbare tegenhanger van
PATCH .../holder: dat endpoint maakt gratis
bewerkingen en stuurt kostendragende wijzigingen naar het portaal met 402; dit
endpoint belast de standaard betaalmethode van het account en past de
wijziging asynchroon toe. Retourneert dezelfde 202 Accepted bestel-/winkelwagen-envelope
als POST /api/orders — poll de geretourneerde bestelling via
/api/orders/:id.
OAuth-geblokkeerd; vereist een gebruiker met bestelrechten
Niet op de domains:write-allowlist — OAuth-toegangstokens kunnen dit niet
bereiken. Vereist een gebruiker-scoped credential (bestellingen zijn
eigendom van een User): een system Account-bearer key retourneert 401
user_required, en een gebruiker zonder rechten om een bestelling aan te
maken retourneert 403 forbidden. Net als bij andere mutaties wijst een
lopend registrarproces af met 409 registration_busy.
Params (geef exact ÉÉN bron voor de nieuwe eigenaar op)
- source_domain_contact_id: Integer | hergebruik een bestaand contact dat eigendom is van het account
- new_contact: Object | maak een nieuw eigenaarscontact aan
- first_name | last_name: String | minstens één is vereist
- country (ISO-2), email, phone: vereist. Telefoon is E.164
+CC.NUMBER; een nationaal nummer zoals0612345678wordt omgezet aan de hand vancountry - organization, street_address, post_code, city, state: String | optioneel
- extra_properties: Object | optioneel, TLD-specifieke registry-velden
Retourneert 202 met de bestel-/winkelwagen-envelope.
Fouten
- 401
user_required| system Account-bearer key (geen gebruiker) - 403
forbidden| gebruiker mist rechten om een bestelling aan te maken - 403
trial_account| proefaccounts kunnen niet bestellen - 409
registration_busy| er loopt al een registrarproces - 400
no_default_payment_method| geen opgeslagen standaardbetaalmethode om mee te belasten. Dit wordt gecontroleerd voordat er iets wordt opgebouwd, dus er wordt niets aangemaakt en niets in rekening gebracht - 400
billing_details_incomplete| het factuurcontact van het betalende account is onvolledig - 403
billing_permission_required| de gebruiker mag de facturatie van het betalende account niet beheren - 409
bank_transfer_in_progress| een eerdere bestelling van de betaler is nooit voltooid; neem contact op met support - 409
bank_transfer_busy| een andere bestelling van de betaler wordt geplaatst; probeer het over enkele seconden opnieuw - 422
outstanding_balance_exceeded| de betaler zit boven de limiet voor openstaand saldo; betaal de openstaande facturen - 422
recent_dispute| een teruggeboekte betaling of chargeback in de afgelopen 90 dagen - 422
bank_transfer_refused| de bestelling kan niet per bankoverschrijving worden gefactureerd - 422
bank_transfer_failed| de bestelling stopte nadat ze was gefactureerd. Niet opnieuw proberen; neem contact op met support - 422
source_contact_not_found|source_domain_contact_idniet gevonden (let op:422hier vs404op/holder) - 422
contact_invalid|new_contactmist vereiste velden of is door de registry afgewezen (bevatviolations) - 422
no_registrant_change_price| geen houderwijzigingsprijs geconfigureerd voor dit account/deze TLD - 422
cart_pay_failed| betaling kon niet worden gestart (een voor de bestelling aangemaakt contact wordt verwijderd) - 422
domain_import_held| de registratie is geblokkeerd
Daarnaast kan het 409 postpay_busy en 422 in_flight_limit_exceeded,
payer_in_dunning, instant_payment_method_required, postpay_route_changed, postpay_failed en de
postpay_*-blokkeringen postpay_pay_open_invoices, postpay_contact_support
en postpay_payment_in_progress geven; zie Bestellingen.
Rolcontacten bijwerken
PATCH /api/domain_registrations/:id/contacts
Stel rolcontacten voor admin / tech / facturatie in (de houder wordt gewijzigd
via /holder). Elke rol is onafhankelijk optioneel. Kies voor elke aanwezige rol
één bron:
{role}_contact: { source: "same_as_owner" }{role}_contact: { source: "existing" }+{role}_source_domain_contact_id: <id>{role}_contact: { source: "new" }+{role}_new_contact: { ...velden... }
Fouten
- 422
owner_contact_missing|same_as_ownergebruikt zonder ingesteld houdercontact
De EPP-/authcode ophalen
GET /api/domain_registrations/:id/epp_code
Vereist de domains:write-scope, ook al is het een GET. Retourneert
{ "authcode": "..." }.
Fouten
- 422
server_transfer_prohibited| registry heeft verhuizingen verboden - 422
authcode_unavailable| TLD verbergt de authcode (authcode_behavior: hidden) - 422
domain_import_held| registratie is geblokkeerd - 502
authcode_unavailable| registrar gaf de authcode niet terug
Geforceerd opnieuw synchroniseren
POST /api/domain_registrations/:id/force_sync
Leest het domein opnieuw uit bij de registrar en synchroniseert de lokale staat.
Geretourneerde params
- domain_registration: Object | ververst
- changed:
Array<String>| namen van velden die zijn gewijzigd
Een lopende uitgaande verhuizing afhandelen
POST /api/domain_registrations/:id/transfer_out
Params
- decision: String (vereist) |
approveofreject
Fouten
- 422
no_pending_transfer_out - 422
invalid_decision
Push-verhuizing naar een andere provider
POST /api/domain_registrations/:id/push_transfer
Registrar-naar-registrar push-verhuizing (geen authcode). Retourneert 200 of 202.
Params
- recipient: String (vereist) | doel-registrar-handle (bijv. "REG-IDS")
Fouten
- 422 | de registrar heeft de push-verhuizing afgewezen — de TLD ondersteunt er geen, er loopt er al een, of het domein is niet verhuisbaar
Dit endpoint retourneert geen foutcode
Een afgewezen push-verhuizing antwoordt met 422 en een errors-array,
zonder enige code-sleutel, dus er is geen machineleesbare identifier om
op te vertakken. Behandel elke 422 hier als één uitkomst
("push-verhuizing afgewezen") en toon de tekst uit errors; vertak niet op
push_transfer_unsupported, push_transfer_in_progress of
domain_not_transferable — die strings worden nooit verstuurd.
Verificatie van houdercontact opnieuw verzenden
POST /api/domain_registrations/:id/resend_contact_verification
Voor TLD's die verificatie van het houdercontact vereisen. Retourneert
{ "status": "queued" }.
Fouten
- 422
verification_not_applicable| TLD vereist geen validatie, of geen houdercontact
Hosts (glue records)
Glue records voor een registratie. Genest onder
/api/domain_registrations/:domain_registration_id/hosts. De route-param is
:host_name.
Hosts weergeven
GET .../hosts
Geretourneerde params
- hosts:
Array<Object>- host_name: String | bijv. "ns1.example.com"
- addresses:
Array<Object>- address: String | IP-literal
- version: Integer | 4 of 6
Een host aanmaken
POST .../hosts
De hostname moet een subdomein van de registratie zijn. Elk adres wordt
automatisch geclassificeerd als IPv4/IPv6. Retourneert 201 { "host": { ... } }.
Params
- host_name: String (vereist) | volledig gekwalificeerd subdomein
- addresses:
Array<Object>(vereist, ten minste één)- address: String | IP-literal (geen CIDR)
De adressen van een host bijwerken
PATCH .../hosts/:host_name
Vervangt de adressenset. Retourneert 200.
Params
- addresses:
Array<Object>(vereist) | zelfde vorm als bij aanmaken
Een host verwijderen
DELETE .../hosts/:host_name
Retourneert 204.
Processen
registrarprocessen die aan een registratie zijn gekoppeld — elke asynchrone
registrar-operatie opent er een. Poll deze na een 202. Genest onder
/api/domain_registrations/:domain_registration_id/processes.
Processen weergeven
GET .../processes
Retourneert { "processes": [ ... ] }, nieuwste eerst (ruwe registrarprocesrecords).
Een proces ophalen
GET .../processes/:id
Geretourneerde params
- process: Object | ruwe registrarprocesbody
- log:
Array<Object>
Een proces waarvan de identifier niet bij de registratie hoort, retourneert 404.
Fouten
- 503
registrar_unavailable| er is geen registrar geconfigureerd voor deze TLD - 502
process_unavailable| de registrar kon het proces niet teruggeven
Een onderbroken proces hervatten
POST .../processes/:id/resend
Retourneert { "status": "queued" }.
Een proces annuleren
DELETE .../processes/:id/cancel
Retourneert { "status": "cancelled" }.