Registering a Domain Name
Synopsis
| Description | A command for registering a domain name. |
| URL | https://toolkit.centralnic.com/srv/register |
| HTTP Method | POST |
| Requires Authentication? | Yes |
| Requires SSL? | Yes |
| Query Parameters: | |
| test | The test flag (eg 1 or 0, optional) |
| user | Your Registrar ID (eg H12345) |
| password | Your Toolkit Password |
| domain | The domain prefix (eg example) |
| suffix | The domain suffix (eg uk.com) |
| chandle | The Registrant |
| ahandle | The Administrative Contact (optional) |
| thandle | The Technical Contact |
| bhandle | The Billing Contact (optional) |
| period | The registration period (optional) |
| dns[] | The DNS server information (optional, multiple) |
This is a method for doing domain registrations with an instant response.
- domain must follow the usual rules for a domain name (alphanumerics and hyphen, between 3 and 64 characters).
- suffix must be a valid CentralNic suffix.
- chandle, ahandle, thandle and bhandle must be an existing contact ID, eg: H12345. You can create new contact objects using the create_handle function.
-
you can have 0 - 13 dns[] lines, specifying a nameserver (and optional IP address, separated by a double colon, and an optional IPv6 address), like so:
dns[]=ns0.example.com&dns[]=ns1.example.com&dns[]=ns2.example.com::192.168.1.1::fc7::1001:1
- period is the registration period in years. Currently CentralNic supports registrations for between 1 and 10 years. If omitted, the default period (2 years) is used.
Response Format
Responses from the server will have the form
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 0 Message: Registration successfully completed domain: example suffix: uk.com chandle: H12345 ahandle: H12345 thandle: H12345 bhandle: H12345 registrar: H12345 amount: 65.00
A status value of 0 denotes a successful registration. A value of 1 indicates an error, with an optional error message on the Message line.
The registrant parameter is a legacy parameter and contains the name and company of the domain's registrant.
The chandle, ahandle, thandle and bhandle fields either confirm the use of an existing contact or identify the contact created.
The amount field indicates the cost of the registration (excluding VAT).
Legacy Parameters
Prior to September 2006, the chandle and thandle parameters could contain new contact data in double colon-separated format. While this parameter format is still supported, its use is not recommended in new client code, and so is not documented here. These fields could also accept a string such as "chandle=thandle" or "chandle=thandle", but this usage is also deprecated.
This command also once accepted a registrant parameter, which was used to set the registrant of the domain name. At the time, the registrant was represented as a text string containing the registrant's name. This representation is now deprecated, and the chandle parameter is now used for the registrant of a domain name. If this parameter is set in your request, it will be ignored.