Ga naar de inhoud
agovena.
agovena.
Aan de slag
Community

Providerhandleidingen

Namecheap Domains: instellen en beheren

Controleer beschikbaarheid, registreer en verleng domeinen via de Namecheap XML-API en beheer hostrecords op Namecheap BasicDNS.

Op deze pagina

Status en werkwijze

De Namecheap Domains-extension koppelt de Domains Module in twee rollen aan Namecheap. namecheap-registrar verzorgt beschikbaarheid, registratie, verlenging en statusverversing via de Namecheap XML-API. namecheap-dns beheert hostrecords op Namecheap BasicDNS voor domeinen in hetzelfde Namecheap-account. Elke opdracht is een form-encoded HTTP POST naar het sandbox- of live-endpoint.

Production-ready voor de gedocumenteerde scope. Elke bewerking onder Ondersteunde bewerkingen is gebouwd op de Namecheap XML-API-opdrachten en geverifieerd met geautomatiseerde tests die de provider vervangen door gesimuleerde HTTP-antwoorden, zonder netwerkcalls. Live acceptatie op je eigen Namecheap-account blijft de verantwoordelijkheid van de beheerder: voer één registratie, verlenging en DNS-wijziging uit in de Namecheap-sandbox en daarna op je live account vanaf het toegestane IPv4-adres. Bewerkingen onder Niet ondersteund worden niet aangeboden.

Vereisten

  • Agovena Core ^0.0.1.
  • De Domains Module, geactiveerd vóór deze extension.
  • Een Namecheap-account met API-toegang en het publieke IPv4-adres van je Agovena-server op de API-allowlist. Namecheap accepteert alleen IPv4.
  • Sandbox en live gebruiken aparte accounts, API-keys en allowlists.
  • Een cache store met atomic locks, zoals Redis, database, file, Memcached of DynamoDB, voor DNS-wijzigingen.

Het pakket instellen

  1. Activeer de Domains Module, open daarna Admin > Extensies en activeer Namecheap Domains.
  2. Zet API-toegang aan in het Namecheap-dashboard en voeg het publieke IPv4-adres van de server toe aan de allowlist.
  3. Sla api_user, api_key, username en client_ip op. De API-key wordt als secret bewaard en alleen in de POST-body verstuurd, nooit in een URL, log of exception.
  4. Laat sandbox aan (https://api.sandbox.namecheap.com/xml.response) tot een registratie, verlenging en DNS-wijziging in de sandbox slagen.
  5. Zet sandbox uit om https://api.namecheap.com/xml.response te gebruiken met live gegevens en de live allowlist.
  6. Registratie gebruikt de ingestelde looptijd in jaren, van 1 tot 10.

Ondersteunde bewerkingen

  • Beschikbaarheid met namecheap.domains.check. IDN-namen (xn--) en TLD's die extended attributes vereisen (.us, .eu, .ca, .co.uk, .org.uk, .me.uk, .nu, .com.au, .net.au, .org.au, .es, .nom.es, .com.es, .org.es, .de, .fr) worden zonder call naar Namecheap als niet beschikbaar gemeld. Premium namen en namen met een Early Access-toeslag zijn niet beschikbaar. De prijs is de eenjarige REGISTER-prijs van je account uit namecheap.users.getPricing, één uur gecachet. Zonder bruikbare prijs blijft het domein beschikbaar zonder prijs.
  • Registratie met namecheap.domains.create. Het contact komt uit het standaard factuuradres van de klant, of het oudste adres, en wordt voor alle vier de rollen gebruikt. Nodig zijn voor- en achternaam, adresregel, plaats, regio, postcode, land in ISO 3166-1 alpha-2, e-mailadres en een telefoonnummer in de vorm +<landcode> <nummer>. Ontbrekende velden worden geweigerd voor er een call vertrekt. Domain privacy wordt niet aangevraagd en er worden geen eigen nameservers verstuurd, dus nieuwe domeinen gebruiken BasicDNS.
  • Statusverversing voor registraties in registering. Het geplande commando agovena:refresh-domain-registrations leest alleen namecheap.domains.getInfo.
  • Verlenging met namecheap.domains.renew voor niet-premium domeinen in bezit van de API-gebruiker met een vastgelegde vervaldatum.
  • DNS-zonecontrole met namecheap.domains.dns.getList. Die is alleen-lezen en vereist dat het domein BasicDNS gebruikt.
  • DNS-records voor A, AAAA, CNAME, MX en TXT. A vraagt IPv4, AAAA vraagt IPv6, MX vraagt een prioriteit van 0 tot 65535 en de TTL moet tussen 60 en 60000 seconden liggen. Namen mogen @, relatief of volledig binnen het domein zijn.

Niet ondersteund

  • TLD's die extended attributes vereisen, IDN-registraties, premium en Early Access-registraties, en premium verlengingen.
  • Transfers, heractivering, contactwijzigingen, domain privacy, registrar lock, auth codes en nameserverwijzigingen, ook domains.dns.setDefault en domains.dns.setCustom.
  • URL-, URL301-, FRAME-, CAA-, ALIAS-, NS- en MXE-hosts bewerken. Ze blijven behouden en kunnen worden verwijderd.
  • E-mail forwarding, dynamic DNS, child nameservers en een health check callback.

Foutafhandeling en eigendom

  • Namecheap meldt fouten in een HTTP 200-body. Alleen Status="OK" met een antwoord op de gevraagde opdracht wordt geaccepteerd. Bij Status="ERROR" blijft alleen het gedocumenteerde foutnummer over, omdat de providertekst verzoekwaarden kan herhalen.
  • Niet-2xx-antwoorden, redirects, lege of niet-XML-bodies en onbekende structuren falen. XML met een DOCTYPE wordt voor het parsen geweigerd en externe entities worden nooit geladen.
  • Voor domains.create en domains.renew wordt elk niet-definitief antwoord, ook een timeout, gemeld als onbekende uitkomst die reconciliatie vraagt. Opnieuw proberen is veilig, omdat beide workflows met alleen-lezen controles beginnen.
  • Voor registratie meldt domains.getInfo een domein dat al in je account staat als active in plaats van het opnieuw te registreren. Een domein in het account dat niet van de API-gebruiker is, wordt geweigerd.
  • Voor verlenging wordt de vervaldatum bij de provider vergeleken met de vastgelegde datum. Is een eerdere verlenging al gelukt, dan wordt die als active gemeld en wordt niets afgeschreven. Elk ander verschil wordt geweigerd voor handmatige reconciliatie.
  • DNS-wijzigingen zijn read-modify-write: getHosts, één wijziging, daarna setHosts met de volledige lijst onder een lock per domein. Alle andere hosts, MX-prioriteiten en TTL's worden exact teruggeschreven zoals gelezen. Record-ID's zijn fingerprints, dus een record dat sinds het tonen is gewijzigd, wordt geweigerd.
  • Eigen MX-hosts gebruiken EmailType=MX. Gebruikt het domein een Namecheap-mailinstelling zoals forwarding of Private Email, dan wordt het toevoegen of behouden van MX-hosts geweigerd in plaats van die instelling om te zetten.
  • In de demo-omgeving worden alle HTTP-calls geweigerd.

Configuratiecontract

Veld Type Verplicht Geheim Standaard
api_user string Nee Nee Leeg
api_key string Nee Ja Leeg
username string Nee Nee Leeg
client_ip string Nee Nee Leeg
sandbox boolean Nee Nee true

Alle velden zijn optioneel in het manifest, maar elke API-call heeft api_user, api_key, username en een toegestaan IPv4-adres in client_ip nodig. Andere waarden voor client_ip worden voor elk verzoek geweigerd. Bewaar geheime waarden alleen in de beschermde extension-instellingen, nooit in productbeschrijvingen, URL's, screenshots of gedeelde voorbeelden.

Bekijk het pakket

Bronnen

Doorzoek de documentatie

Zoek handleidingen, commando’s en API-endpoints

Waar ben je naar op zoek?

Documentatie