NiceNIC Domein API v2 Veelgestelde vragen

NiceNIC Domain API v2 is een API op basis van HTTPS en JSON voor het automatiseren van domeinbeheer via uw NiceNIC-account.

Het ondersteunt kernworkflows, waaronder domeinbeschikbaarheidscontroles, registratie, verlenging, overdracht, portfolio-query's, nameserver- en contactupdates, prijzen, DNS-records, child-nameservers, accountinformatie en nalevingsgerelateerde bewerkingen.

Gebruik de API wanneer u NiceNIC-domeindiensten rechtstreeks wilt koppelen aan een website, hostingplatform, factureringssysteem, intern hulpmiddel of andere toepassing.

Elk actief NiceNIC-account kan Domain API v2 gebruiken. API-toegang is beschikbaar voor zowel marktaccounts als reselleraccounts.

U hoeft geen reseller te worden om API-toegang te verkrijgen. Het accounttype is nog steeds van belang voor de prijzen: betaalde API-bewerkingen gebruiken de prijzen die zijn toegewezen aan het NiceNIC-account dat de aanvraag verzendt.

Open API-instellingen →

Ja. API-toegang zelf is gratis. Er worden geen afzonderlijke kosten in rekening gebracht voor het inschakelen van API-toegang of voor het verzenden van ondersteunde API-aanvragen.

Betaalde handelingen zoals domeinregistratie, verlenging en overdracht worden in rekening gebracht volgens de prijzen van uw account en de geldende domeinregels.

Nee. API-toegang en resellerprijzen zijn gescheiden zaken.

U kunt Domain API v2 gebruiken met een gewoon NiceNIC-marktaccount. Upgrade alleen naar een reselleraccount wanneer resellerprijzen of andere resellervoordelen nuttig zijn voor uw bedrijfsvolume.

Resellerplannen vergelijken →

Domain API v2 gebruikt de huidige NiceNIC API-structuur met HTTPS-verzoeken, JSON-antwoorden, authenticatie op basis van headers en documentatie die is georganiseerd rond afzonderlijke domein- en accountworkflows.

Als u een integratie onderhoudt die is gebouwd op een oudere NiceNIC API, controleer dan de API v2-parameters en de verwerking van antwoorden voordat u productieverkeer migreert, in plaats van aan te nemen dat de twee versies onderling uitwisselbaar zijn.

Log in op uw NiceNIC-account en open API-instellingen. API v2-verzoeken gebruiken uw NiceNIC-gebruikersnaam en API Secret voor authenticatie.

Open API-instellingen →

Ja. NiceNIC biedt een API-sandbox voor ontwikkelaars om integraties te testen voordat ze worden verbonden met de productie-API.

Gebruik de sandbox om authenticatie, verzoekopmaak, responsverwerking, foutafhandeling en uw applicatieworkflow te valideren voordat u live klantdomeinoperaties inschakelt.

API-sandbox openen →

De API-sandbox is bedoeld voor ontwikkeling en integratietests. De productie-API wordt gebruikt voor live domeinoperaties en betaalde verzoeken op uw NiceNIC-account.

Wij raden aan om authenticatie, verzoekafhandeling, responsverwerking en foutlogica te valideren in de sandbox voordat u productieoperaties voor klanten inschakelt.

Verstuur API-verzoeken via HTTPS en neem uw NiceNIC-gebruikersnaam en API Secret op in de Authorization-header.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

Als er IP-beperkingen zijn ingeschakeld voor uw account, moeten verzoeken ook afkomstig zijn van een geautoriseerd server-IP.

Lees API-authenticatie →

Het basis-eindpunt van de productie-API is:

https://api.nicenic.net/v2/

API-acties worden geselecteerd met de parameters die voor elk eindpunt zijn gedocumenteerd, zoals category en action. Volg altijd de specifieke eindpuntdocumentatie voor de vereiste en optionele parameters van een bepaalde bewerking.

API v2-antwoorden gebruiken JSON en aanvraagparameters gebruiken UTF-8.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

Uw toepassing moet de geretourneerde code en msg controleren in plaats van aan te nemen dat elke HTTP-respons een voltooide domeinbewerking vertegenwoordigt.

Met de momenteel gedocumenteerde API's kunt u workflows automatiseren, waaronder het controleren van domeinbeschikbaarheid, registratie, verlenging en overdracht, portfoliolijst en domeingegevens, naamserver- en domeincontactupdates, domeinprijzen, DNS-records, kindernaamservers, accountgegevens en toezicht op misbruik en naleving.

Aanvullende workflows worden afzonderlijk gedocumenteerd in de API-navigatie.

Begin met risicovrije leesoperaties, zoals domeinbeschikbaarheid, domeinprijzen, accountsaldo en domeinlijst.

Bevestig vervolgens authenticatie, responsparsing, foutafhandeling en verwerking van lopende bestellingen voordat u live registraties, verlengingen of overdrachten inschakelt.

Ja. Het eindpunt Check Domain Availability ondersteunt meerdere domeinnamen gescheiden door komma's.

example.com,example.net,example.org

Ga er niet vanuit dat elke API-bewerking hetzelfde meerdomein-invoerformaat ondersteunt. Registratie, verlenging en overdracht moeten hun eigen eindpuntdocumentatie volgen.

Gebruik het eindpunt Get Domain Pricing. De gedocumenteerde prijstypen omvatten register, renew, transfer en all.

Registratieresponsen kunnen ook een is_premium-waarde bevatten die aangeeft of de opgevraagde registratie premium is.

Omdat API-bestellingen gebruikmaken van prijzen op accountniveau, dient u vóór het indienen van betaalde klantbestellingen de actuele prijzen op te vragen in plaats van onbeperkt te vertrouwen op gecachte prijzen.

Nee. Hoewel de API-documentatie voor toepasselijke extensies perioden tot 1–10 jaar ondersteunt, kunnen individuele TLD's afwijkende registerregels hanteren.

Registratieperioden, verlengingsperioden, overdrachtsgeschiktheid, contactvereisten en verificatievereisten kunnen per extensie verschillen. Uw applicatie moet de actuele regels voor de betreffende TLD volgen.

Dit zijn afzonderlijke bewerkingen en mogen niet als onderling uitwisselbaar worden behandeld.

Gebruik altijd de geretourneerde code en het bericht bij het bepalen van de status van een API-aanvraag.

Bekijk API-responscodes →

Een 201-respons betekent dat de bewerking is geaccepteerd voor verwerking, maar niet noodzakelijkerwijs de definitieve status heeft bereikt.

Voor domeinregistratie geeft een 201-respons aan dat de bestelling is ingediend en in afwachting is van de definitieve verwerking door het register.

Vertel een eindklant niet dat het domein actief is totdat uw systeem het definitieve resultaat heeft bevestigd. Raadpleeg de documentatie van het registratie-eindpunt voor de nieuwste regels voor in behandeling zijnde bestellingen en terugbetalingen.

Een overdracht in behandeling betekent dat het overdrachtsverzoek is geaccepteerd voor verwerking, niet dat het domein de overdracht naar NiceNIC al heeft voltooid.

Het voltooien van de overdracht kan afhangen van de verwerking door het register en de registrar, evenals van de huidige overdrachtsstatus van het domein. Houd de overdracht in behandeling totdat de voltooiing is bevestigd.

Ja. De List Domains-API ondersteunt het ophalen van portfolio's met paginering, sortering en filteropties.

Gebruik Get Domain Details wanneer u gedetailleerde informatie nodig hebt voor een individueel domein, zoals registratiegegevens, vervalinformatie, nameservers en domeincontactgegevens.

NiceNIC Domain API v2 bevat Abuse & Compliance-bewerkingen die zijn ontworpen voor platforms en resellers die klantdomeinportfolio's beheren.

U kunt domeinen identificeren die verband houden met misbruikrapporten en machineleesbare compliance-informatie voor individuele domeinen ophalen. Afhankelijk van het geval kan de reactie domeinstatus, huidige impact, aanbevolen actie, hold-informatie, klachtinformatie en gerapporteerde URL's bevatten.

Dit maakt het mogelijk om de compliancestatus rechtstreeks in uw eigen klantenportaal of operationeel systeem weer te geven.

Ja. NiceNIC biedt een WHMCS-registrarintegratie voor bedrijven die WHMCS al gebruiken voor facturatie en provisioning.

Gebruik de directe Domain API v2 wanneer u uw eigen applicatie of workflow bouwt. Gebruik de WHMCS-integratie wanneer u domeinoperaties wilt integreren in een bestaande WHMCS-omgeving.

Bekijk WHMCS-integratie →

Elke server-side programmeertaal of runtime die HTTPS-verzoeken kan verzenden en JSON kan parsen, kan worden geïntegreerd met Domain API v2.

Veelgebruikte keuzes zijn PHP, Python, Node.js en Java. Houd API-referenties server-side en stel uw API Secret nooit bloot in browser-side JavaScript of downloadbare clientcode.

Er kan een ratelimiet worden toegepast om de API-stabiliteit en platformbeveiliging te beschermen.

Als uw productie-integratie naar verwachting een aanhoudend hoog verzoekvolume genereert, neem dan vóór de lancering contact op met NiceNIC, zodat uw verwachte gebruikspatroon kan worden beoordeeld.

Vermeld het tijdstempel van het verzoek, de API-categorie en -actie, de domeinnaam indien van toepassing, niet-gevoelige verzoekparameters, de geretourneerde responscode en -melding, en of het verzoek afkomstig was uit Sandbox of Production.

Verzend een ticket →

Gebruik de API-navigatie in de documentatie. Elke bewerking heeft een eigen pagina voor ondersteunde parameters, verzoekvoorbeelden, responsvoorbeelden en bewerkingsspecifiek gedrag.

De FAQ legt het algemene gedrag van de API uit; de documentatie van de afzonderlijke eindpunten moet worden beschouwd als de bron van waarheid voor het exacte verzoekformaat.

API-documentatie openen →