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
- Activeer de Domains Module, open daarna Admin > Extensies en activeer Namecheap Domains.
- Zet API-toegang aan in het Namecheap-dashboard en voeg het publieke IPv4-adres van de server toe aan de allowlist.
- Sla
api_user,api_key,usernameenclient_ipop. De API-key wordt als secret bewaard en alleen in de POST-body verstuurd, nooit in een URL, log of exception. - Laat
sandboxaan (https://api.sandbox.namecheap.com/xml.response) tot een registratie, verlenging en DNS-wijziging in de sandbox slagen. - Zet
sandboxuit omhttps://api.namecheap.com/xml.responsete gebruiken met live gegevens en de live allowlist. - 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 eenjarigeREGISTER-prijs van je account uitnamecheap.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 commandoagovena:refresh-domain-registrationsleest alleennamecheap.domains.getInfo. - Verlenging met
namecheap.domains.renewvoor 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.setDefaultendomains.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. BijStatus="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
DOCTYPEwordt voor het parsen geweigerd en externe entities worden nooit geladen. - Voor
domains.createendomains.renewwordt 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.getInfoeen domein dat al in je account staat alsactivein 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
activegemeld en wordt niets afgeschreven. Elk ander verschil wordt geweigerd voor handmatige reconciliatie. - DNS-wijzigingen zijn read-modify-write:
getHosts, één wijziging, daarnasetHostsmet 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.