Providerhandleidingen
Namecheap Domains: instellen en beheren
Koppel de Domain-module aan beschikbaarheidscontrole, registratie en verlenging bij Namecheap via de XML-API.
Op deze pagina
Werkwijze bij de provider
Koppel de Domain-module aan beschikbaarheidscontrole, registratie en verlenging bij Namecheap via de XML-API. De registrarsleutel is namecheap-registrar, anders dan pakket-ID namecheap-domain. Dit pakket registreert geen aparte DNS-providerrol.
Vereisten
Agovena Core ^0.0.1. Activeer Domain vóór deze uitbreiding.
Deze uitbreiding is niet als productierijp gemarkeerd. Controleer de ondersteunde werkwijze in je eigen testomgeving voordat je klantbestellingen aanneemt.
Het pakket instellen
Stel api_user, het geheime api_key, username, client_ip en sandbox in. Sandbox staat standaard aan. De eerste vier velden zijn volgens het manifest optioneel, maar de HTTP-client weigert verzoeken als één ervan leeg is. Selecteer namecheap-registrar op het product en gebruik provider_settings.years voor de gewenste registratieduur.
Providerspecifieke grenzen
De client verstuurt formuliergegevens naar https://api.sandbox.namecheap.com/xml.response of https://api.namecheap.com/xml.response. De gebruikte opdrachten zijn namecheap.domains.check, namecheap.domains.create en namecheap.domains.renew. Het domein moet een volledige ASCII-domeinnaam zijn. Gebruik het toegestane client-IP en de API-toegangsregels voor je testomgeving.
Begin met een beschikbaarheidscontrole in sandbox en controleer dat een ontbrekend domeinantwoord als niet beschikbaar wordt behandeld. Bekijk bij verlenging zowel de succesvlag als het registraraccount, want de adapter geeft geen vervaldatum terug. Verkoop nog geen automatische nieuwe registraties op basis van deze instellingen alleen. Het registratiecontract vereist contactgegevens die niet in het adapterverzoek zitten. Zet die persoonsgegevens niet in willekeurige extra instellingen in de verwachting dat ze worden doorgestuurd. Maak eerst het adaptercontract compleet en test registratie, fouten en verlenging afzonderlijk. 2
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 |
Dit zijn de velden uit het manifest. Een optioneel veld kan voor een API-handeling toch noodzakelijk zijn, zoals hierboven beschreven. Bewaar geheime waarden alleen in beschermde instellingen, nooit in productbeschrijvingen, URL’s of gedeelde voorbeelden. 1
Werking en foutafhandeling
De adapter controleert XML-status en providerfouten en vertaalt registratie of verlenging naar actief of mislukt. Deze antwoorden vullen geen vervaldatum in. Het huidige registratieverzoek verstuurt naast authenticatie alleen DomainName en Years, terwijl Namecheap verplichte contactgegevens voor de registrant beschrijft. Nieuwe registratie is daarom onvolledig totdat die gegevens correct worden aangeleverd en getest. Opgeslagen API-gegevens maken dit nog geen productierijpe registrar.