API-overzicht
NiceNIC Domain API v2-documentatie en snelstartgids
De NiceNIC Domain API v2 is beschikbaar voor zowel marktaccounts als reselleraccounts. Gebruik dit overzicht om toegang te configureren, uw eerste aanvraag te bevestigen, het API-responsmodel te begrijpen en direct naar de juiste sectie in de linkernavigatie te gaan.
API-toegang en resellerprijzen zijn gescheiden.
Market-account: API-toegang met Market-accountprijzen.
Reseller-account: API-toegang met de prijzen die zijn toegewezen aan het huidige resellerniveau.
Vergelijk resellerniveaus en prijzen →
Market-account: API-toegang met Market-accountprijzen.
Reseller-account: API-toegang met de prijzen die zijn toegewezen aan het huidige resellerniveau.
Vergelijk resellerniveaus en prijzen →
Basis endpoint
https://api.nicenic.net/v2/
Vereiste headers
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Standaard succesrespons
{ "code": 0, "msg": "success", "data": {} }
API-sandbox
Test uw integratie voordat u live gaat
Gebruik de NiceNIC API-sandbox om uw Domain API-integratie te testen voordat u naar productie overgaat. Valideer authenticatie, API-verzoeken, responsafhandeling en uw applicatieworkflow in een dedicated testomgeving.
Ideaal voor resellers, hostingproviders, ontwikkelaars en platforms die een API-integratie voorbereiden.
Snelstart
Doe uw eerste API-aanroep in 4 stappen
Begin met een alleen-lezen aanvraag voordat u live registraties, verlengingen of overdrachten inschakelt. Zo kunt u de authenticatie, het aanvraagformaat en de verwerking van antwoorden valideren zonder een betaalde bestelling te plaatsen.
1
API-toegang inschakelen
Open de API-instellingen, maak een API Secret aan of haal deze op, en configureer waar van toepassing geautoriseerde server-IP's.
2
Authenticatie bevestigen
Gebruik HTTPS met de Authorization-header in de notatie username:api_secret.
3
Voer een veilige test uit
Begin met domeinbeschikbaarheid, prijzen, accountsaldo of domeinvermelding.
4
Verwerk de respons
Lees en bewaar de geretourneerde code en msg voordat u betaalde productieacties inschakelt.
Aanbevolen eerste aanvraag: beschikbaarheid van domeinen
Het beschikbaarheidseindpunt ondersteunt meerdere domeinen in één aanvraag door domeinnamen te scheiden met komma's.
curl "https://api.nicenic.net/v2/?category=domain&action=check&domains=example.com,example.net" \ -H "Authorization: username:api_secret" \ -H "Content-Type: application/json"
API-kaart
Kies de workflow die u nodig hebt
Het overzicht hieronder volgt de navigatie aan de linkerkant. Gebruik het om de juiste workflow te identificeren en open vervolgens de dedicated endpointpagina voor parameters, voorbeeldverzoeken en voorbeeldantwoorden.
| Sectie | Gebruik het voor | Gedocumenteerde functies |
|---|---|---|
| Aan de slag | Maak veilig verbinding en begrijp de verwerking van reacties. | API-overzicht, API-sandbox, authenticatie, responscodes. |
| Domeinbeheer | Automatiseer de kernlevenscyclus van domeinen. | Beschikbaarheid, domeinen weergeven, domeindetails, registratie, verlenging, overzetten (inkomend), naamservers, contactpersonen, prijzen. |
| Misbruik & Compliance | Bewaak domeinen die aandacht voor naleving vereisen. | Geef een lijst van domeinen met misbruikrapporten en haal machineleesbare misbruikstatus, opschortingslevenscyclus, klachtinformatie en aanbevolen acties op. |
| DNS-records | Beheer gehoste DNS-records programmatisch. | DNS-records weergeven, aanmaken, bijwerken en verwijderen. |
| Sub-nameservers | Beheer host- / glue-records voor nameservers onder uw eigen domein. | Child-nameservers aanmaken, weergeven, bijwerken en verwijderen. |
| Account en facturatie | Verbind automatisering met controles op accountniveau. | Accountsaldo en transactiegerelateerde accountinformatie. |
| WHMCS API | Integreer NiceNIC in een bestaande WHMCS-facturatieworkflow. | Beschikbaarheid, registratie, verlenging, overdracht, domeingegevens, nameservers, contactpersonen en aanvullende registrar-modulefuncties. |
| Veelgestelde vragen over API | Los veelvoorkomende vragen over toegang, beveiliging, testen en workflows op. | Geschiktheid, inloggegevens, verzoekafhandeling, ondersteunde bewerkingen en integratiehandleiding. |
Aanbevolen werkwijze
Aanbevolen volgorde voor eerste integratie
Een betrouwbare productie-integratie moet toegangs- en aankoopvoorwaarden valideren voordat er live klantorders worden verzonden.
1. Authenticatie
API Secret + geautoriseerd IP
API Secret + geautoriseerd IP
→
2. Beschikbaarheid
Alleen-lezen connectiviteitstest
Alleen-lezen connectiviteitstest
→
3. Prijzen
Huidige kosten op accountniveau opvragen
Huidige kosten op accountniveau opvragen
→
4. Saldo
Controleer het saldo voor betaalde acties
Controleer het saldo voor betaalde acties
→
5. Responsverwerking
Code + bericht verwerken
Code + bericht verwerken
→
6. Live-operaties
Registreren / Verlengen / Overdragen
Registreren / Verlengen / Overdragen
Ga er niet vanuit dat een API-aanvraag is voltooid alleen omdat deze is geaccepteerd. Sommige bewerkingen kunnen een status 'in behandeling' retourneren en vereisen nog steeds verwerking door het register voordat de uiteindelijke domeinstatus wordt bevestigd.
Gedrag in productieomgeving
Succes-, lopende en foutmeldingen begrijpen
code: 0 — Succesvol antwoord De huidige endpoint-voorbeelden gebruiken code 0 voor succesvol voltooide antwoorden.
code: 201 — Lopende bestelling Documentatie over registratie en overdracht kan code 201 retourneren wanneer een bestelling is ingediend maar de definitieve verwerking nog in behandeling is.
code: 400 — Verzoekfout Endpoint-voorbeelden gebruiken code 400 voor fouten in verzoekparameters.
Gedrag bij in behandeling zijnde registratie
Voor domeinregistratie vermeldt de huidige documentatie dat een 201-reactie betekent dat de bestelling succesvol is ingediend en het bedrag is afgeschreven, maar dat de uiteindelijke activering nog onderworpen is aan bevestiging door de registry. Als het domein niet kan worden geactiveerd, wordt het registratiegeld binnen 24 uur teruggestort op het NiceNIC-accountsaldo.
Gedrag bij in behandeling zijnde overdracht
Het overdrachtseindpunt documenteert 201 ook als een in behandeling zijnde bestelling. Uw applicatie moet een in behandeling zijnde overdracht daarom behandelen als geaccepteerd voor verwerking, niet als bewijs dat de overdracht al is voltooid.
Prijzen
Prijzen opvragen vóór betaalde bewerkingen
Het prijsopvraageindpunt van NiceNIC kan de registratie-, verlengings- en overdrachtsprijzen voor een domein ophalen. De gedocumenteerde type-waarden zijn register, renew, transfer en all. De gedocumenteerde periode is 1 tot 10 jaar, met mogelijke uitzonderingen per TLD.
Registratieprijsresponsen kunnen ook een is_premium-vlag retourneren. Gebruik het prijsopvraageindpunt voordat u een betaald verzoek indient, wanneer uw applicatie de huidige kosten op accountniveau moet weten.
Gratis API-toegang wijzigt uw prijsklasse niet. Marktaccounts gebruiken de marktaccountprijzen; reselleraccounts gebruiken de prijzen die zijn toegewezen aan hun huidige resellerniveau.
Domein- & DNS-activiteiten
Ken het verschil tussen naamservers, DNS-records en sub-naamservers
| Bewerking | Wanneer gebruiken | Gedocumenteerde functionaliteit |
|---|---|---|
| Nameservers bijwerken | U wilt een domein delegeren naar verschillende gezaghebbende naamservers. | Het domein-naamserver-eindpunt ondersteunt primaire, secundaire en extra naamservers, met op de huidige pagina een gedocumenteerde limiet van maximaal zes. |
| DNS-records | U gebruikt NiceNIC DNS-hosting en moet zonegegevens beheren. | Voor het weergeven, aanmaken, bijwerken en verwijderen van DNS-records zijn afzonderlijke API's gedocumenteerd. |
| Sub-nameservers | U hebt host-/gluerecords nodig, zoals ns1.example.com. |
Maak, vermeld, werk bij en verwijder child-nameservers. Het create-eindpunt vereist dat de hostnaam van de nameserver overeenkomt met de domeinnaam en accepteert een IP-adres. |
Portfolio & Compliance
Automatiseer portfoliobewaking, niet alleen domeinbestellingen
Domain API v2 omvat ook leesbewerkingen die nuttig zijn na registratie. Het List Domains-eindpunt ondersteunt paginering, sortering, statusfiltering en hold-filtering, terwijl Get Domain Details registratiedata, vervaldata, nameservers en contactgegevens van de registrant retourneert.
Monitoring van misbruik en naleving
NiceNIC's API voor misbruik en naleving kan domeinen met misbruikrapporten weergeven en een gedetailleerde machineleesbare samenvatting voor een specifiek domein retourneren. Het gedetailleerde misbruik-endpoint beschrijft zes statuszinnen op domeinniveau: Normal, Under Review, Pending ClientHold, ClientHold, Closed en ServerHold.
De reactie kan de huidige impact, aanbevolen vervolgactie, houdstatus en tijdlijn, aantal klachten, klachtdata, categorieën, DNS-misbruikclassificatie, bewijsstatus en gerapporteerde URL's bevatten, waar van toepassing. Hiermee kunnen platforms en resellers de nalevingsstatus binnen hun eigen operationele systemen weergeven, in plaats van alleen te vertrouwen op handmatige beoordeling.
Directe API of WHMCS
Kies het integratiemodel dat bij uw systeem past
| Optie | Geschikt voor | Wat de huidige documentatie biedt |
|---|---|---|
| Domein-API v2 | Maatwerk websites, SaaS-platformen, interne systemen, aangepaste facturatie- of provisioningworkflows. | Directe HTTPS + JSON-integratie voor domein-, DNS-, child-nameserver-, account- en compliance-activiteiten. |
| WHMCS-module | Hostingbedrijven en resellers die al WHMCS gebruiken. | Beschikbaarheid, registratie, verlenging, overdracht, domeingegevens, nameservers, contacten, vergrendelen/ontgrendelen, EPP-opvraging, foutregistratie en optionele testmodus. |
De huidige WHMCS-documentatie vermeldt WHMCS 7.0 of hoger, PHP 7.0 of hoger met cURL, geldige NiceNIC API-referenties en SSL/TLS-ondersteuning als vereisten.
Probleemoplossing
Wanneer een API-aanvraag mislukt
Begin met de geretourneerde respons en de configuratiestatus in plaats van dezelfde betaalde actie herhaaldelijk opnieuw te proberen.
Authenticatie- of toegangsfout
- Bevestig de NiceNIC-gebruikersnaam en het API-geheim.
- Bevestig dat de Authorization-header aanwezig en correct opgemaakt is.
- Bevestig dat het API-geheim niet is gereset of geroteerd.
- Als IP-beperkingen zijn ingeschakeld, bevestig dan dat het verzoek afkomstig is van het geautoriseerde uitgaande server-IP.
Fout in aanvraagparameter
- Vergelijk de aanvraag met de gedocumenteerde parameters van het specifieke eindpunt.
- Controleer vereiste waarden, formaten en actienamen.
- Controleer waar van toepassing de registratieperioden of contactvereisten die specifiek zijn voor de TLD.
Betaalde bewerking wordt niet onmiddellijk voltooid
- Lees de geretourneerde
codeenmsg. - Beschouw een
201-antwoord dat in afwachting is niet als definitieve voltooiing. - Controleer het accountsaldo en de huidige prijzen voordat u een betaalde actie opnieuw probeert.
NiceNIC-ondersteuning nodig
- Noteer het tijdstempel van het verzoek en de API-actie.
- Vermeld waar van toepassing de domeinnaam of het betreffende object.
- Vermeld de geretourneerde code en het bericht.
- Deel alleen niet-gevoelige parameters; plaats nooit de volledige API-secret in een ticket.
Volgende stap
Begin met een veilige testaanvraag
Schakel API-toegang in, bevestig de authenticatie, voer een beschikbaarheids- of prijsaanvraag uit en controleer uw responsafhandeling voordat u betaalde klantgerichte operaties activeert.
Laatst geverifieerd: 26 augustus 2026
