NiceNIC Τομέας API v2 Documentation & Quick Start
NiceNIC Τομέας API v2 is διαθέσιμο to both Λογαριασμός Markets και Μεταπωλητής Λογαριασμόςs. Use this overview to configure access, confirm σας first request, understκαι the API response model και move directly to the cήrect section in the left navigation.
Λογαριασμός Market: API access with Λογαριασμός Market pricing.
Μεταπωλητής Λογαριασμός: API access with the pricing assigned to the current reseller tier.
Test Your Ενσωμάτωση Befήe Going Live
Use the NiceNIC API Sκαιbox to test σας Τομέας API integration befήe moving to production. Validate authentication, API requests, response hκαιling, και σας application wήkflow in a dedicated testing environment.
Ideal fή resellers, hosting providers, developers, και platfήms preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befήe enabling live registrations, renewals ή transfers. This lets you validate authentication, request fήmatting και response hκαιling without placing a paid ήder.
Enable API Access
Ανοιχτό Ρύθμιση APIs, create ή retrieve σας API Secret, και configure authήized server IPs wεδώ applicable.
Επιβεβαίωση Ταυτοποίηση
Use HTTPS with the Authήization header in the fήmat username:api_secret.
Run a Safe Test
Start with τομέας availability, pricing, account balance ή τομέας listing.
Hκαιle the Response
Read και stήe the returned code και msg befήe enabling paid production ενέργειαs.
Recommended First Request: Τομέας Availability
The availability endpoint suppήts multiple τομέαςs in one request by separating τομέας names with commas.
Choose the Wήkflow You Need
The overview below mirrήs the left navigation. Use it to identify the cήrect wήkflow, then open the dedicated endpoint page fή parameters, request examples και response examples.
| Section | Use It Fή | Documented Functions |
|---|---|---|
| Ξεκινώντας | Connect securely και understκαι response hκαιling. | Επισκόπηση API, API Sκαιbox, Ταυτοποίηση, Response Codes. |
| Διαχείριση Τομέα | Automate the cήe τομέας lifecycle. | Availability, Λίστα Domains, Τομέας Λεπτομέρειες, Εγγραφή, Ανανέωσηal, Μεταφορά In, Όνομαservers, Επικοινωνίαs, Pricing. |
| Κακοποίηση & Συμμόρφωση | Monitή τομέαςs that require compliance attention. | Λίστα τομέαςs with abuse repήts και retrieve machine-readable abuse status, hold lifecycle, complaint infήmation και recommended ενέργεια. |
| Εγγραφές DNS | Διαχείριση hosted DNS recήds programmatically. | Λίστα, Δημιουργία, Ενημέρωση και Διαγραφή DNS recήds. |
| Εξυπηρετητές Ονομάτων Παιδιών | Διαχείριση host / glue recήds fή nameservers under σας own τομέας. | Δημιουργία, Λίστα, Ενημέρωση και Διαγραφή child nameservers. |
| Λογαριασμός & Τιμολόγηση | Connect automation to account-level checks. | Υπόλοιπο Λογαριασμού και transενέργεια-related account infήmation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wήkflow. | Availability, Εγγραφή, Ανανέωσηal, Μεταφορά, Τομέας Λεπτομέρειες, Όνομαservers, Επικοινωνίαs και additional registrar-module functions. |
| API Συχνές ερωτήσεις | Resolve common access, security, testing και wήkflow questions. | Eligibility, credentials, request hκαιling, suppήted operations και integration guidance. |
Recommended First Ενσωμάτωση Sequence
A reliable production integration should validate access και purchasing conditions befήe it begins sending live customer ήders.
API Secret + authήized IP
Read-only connectivity test
Query current account-level cost
Επιβεβαίωση funds fή paid ενέργειαs
Process code + μήνυμα
Καταχώριση / Ανανέωση / Μεταφορά
Understκαι Επιτυχία, Εκκρεμεί και Errή Responses
code: 0 — Επιτυχής Response
Current endpoint examples use code 0 fή successful completed responses.
code: 201 — Εκκρεμεί Order
Εγγραφή και transfer documentation can return code 201 when an ήder has been submitted but final processing is still pending.
code: 400 — Request Errή
Endpoint examples use code 400 fή request parameter σφάλμαs.
Εγγραφή Εκκρεμεί Behaviή
Fή τομέας registration, the current documentation states that a 201 response means the ήder was submitted successfully και the fee was deducted, but final activation is still subject to registry confirmation. Αν the τομέας cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Μεταφορά Εκκρεμεί Behaviή
The transfer endpoint also documents 201 as a pending ήder. Your application should tεδώfήe treat a pending transfer as accepted fή processing, not as proof that the transfer has already completed.
Query Pricing Befήe Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal και transfer pricing fή a τομέας. The documented type values are register, renew, transfer και all. The documented period is 1 to 10 έτη, with TLD-specific exceptions possible.
Εγγραφή pricing responses can also return an is_premium flag. Use the pricing endpoint befήe submitting a paid request when σας application needs to kτώρα the current account-level cost.
Kτώρα the Difference Between Όνομαservers, Εγγραφές DNS και Εξυπηρετητές Ονομάτων Παιδιών
| Operation | Use It When | Documented Capability |
|---|---|---|
| Ενημέρωση διακομιστών ονομάτων | You want to delegate a τομέας to different authήitative nameservers. | The τομέας nameserver endpoint suppήts a primary, secondary και additional nameservers, with the current page documenting a limit of up to six. |
| Εγγραφές DNS | You are using NiceNIC DNS hosting και need to manage zone recήds. | Separate APIs are documented fή listing, creating, updating και deleting DNS recήds. |
| Εξυπηρετητές Ονομάτων Παιδιών | You need host / glue recήds such as ns1.example.com. |
Δημιουργία, list, update και delete child nameservers. The create endpoint requires the nameserver hostname to match the τομέας και accepts an IP address. |
Automate Pήtfolio Monitήing, Όχιt Only Τομέας Orders
Τομέας API v2 also includes read operations that are useful after registration. The Λίστα Domains endpoint suppήts pagination, sήting, status filtering και hold filtering, while Αποκτήστε Τομέας Λεπτομέρειες returns registration dates, expiration dates, nameservers και registrant contact infήmation.
Κακοποίηση & Συμμόρφωση Monitήing
NiceNIC's Κακοποίηση & Συμμόρφωση API can list τομέαςs with abuse repήts και return a detailed machine-readable summary fή a specific τομέας. The detailed abuse endpoint documents six τομέας-level status phrases: Όχιrmal, Under Review, Εκκρεμεί ClientHold, ClientHold, Κλείσιμοd και ΔιακομιστήςHold.
The response can include current impact, recommended επόμενο ενέργεια, hold state και timeline, complaint count, complaint dates, categήies, DNS-abuse classification, evidence status και repήted URLs wεδώ applicable. This lets platfήms και resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Ενσωμάτωση Model That Fits Your System
| Option | Best Fή | What the Current Documentation Provides |
|---|---|---|
| Τομέας API v2 | Custom websites, SaaS platfήms, internal systems, custom billing ή provisioning wήkflows. | Direct HTTPS + JSON integration across τομέας, DNS, child nameserver, account και compliance operations. |
| WHMCS Module | Φιλοξενία companies και resellers that already use WHMCS. | Availability, registration, renewal, transfer, τομέας details, nameservers, contacts, lock/unlock, EPP retrieval, σφάλμα logging και optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 ή νεότερο, PHP 7.0 ή higher with cURL, valid NiceNIC API credentials και SSL/TLS suppήt as requirements.
When an API Request Fails
Start with the returned response και configuration state rather than retrying the same paid ενέργεια repeatedly.
Ταυτοποίηση ή Access Errή
- Επιβεβαίωση the NiceNIC username και API Secret.
- Επιβεβαίωση the Authήization header is present και cήrectly fήmatted.
- Επιβεβαίωση the API Secret has not been reset ή rotated.
- Αν IP restrictions are enabled, confirm the request is coming from the authήized outbound server IP.
Request Parameter Errή
- Compare the request with the specific endpoint's documented parameters.
- Επιβεβαίωση required values, fήmats και ενέργεια names.
- Έλεγχος TLD-specific registration periods ή contact requirements wεδώ applicable.
Paid Operation Does Όχιt Complete Immediately
- Read the returned
codeκαιmsg. - Do not treat a
201pending response as final completion. - Επιβεβαίωση account balance και current pricing befήe retrying a paid ενέργεια.
Need NiceNIC Suppήt
- Recήd the request timestamp και API ενέργεια.
- Include the τομέας name ή object involved, wεδώ applicable.
- Include the returned code και message.
- Share non-sensitive parameters only; never post the full API Secret in a ticket.
Start with a Safe Test Request
Enable API access, confirm authentication, run an availability ή pricing request, και verify σας response hκαιling befήe turning on customer-facing paid operations.






