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 Handle ID |
| password | Your encrypted Registrar password |
| domain | The domain prefix (eg example) |
| suffix | The domain suffix (eg uk.com) |
| registrant | The domain registrant |
| chandle | The Client Handle |
| thandle | The Technical Handle |
| period | The registration period (optional) |
| url | A URL to forward the domain to (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.
- registrant is a text string containing the name of the legal registrant of the domain. The registrant has ultimate ownership and authority over the domain.
-
chandle and thandle can be any of the following:
- an existing handle, eg: H12345. You can create new handles using the create_handle function.
- the name of one of the other handles, eg: thandle: chandle sets the technical handle to whatever the client handle is,
- url may be a URL to which the domain name will be forwarded. To enable this feature, the dns[] parameter will be ignored. If you subsequently add nameservers to the domain, then the forwarding will stop working.
-
you can have 0 - 5 dns[] lines, specifying a nameserver (and optional IP address, separated by a double colon), like so:
dns[]=ns0.example.com&dns[]=ns1.example.com&dns[]=ns2.example.com::192.168.1.1
- period is the registration period in years. Currently CentralNic supports registrations for between 2 and 10 years. If omitted, the default period (2 years) is used.
Legacy Parameters
Prior to September 2006, the chandle and thandle parameters could contain new handle 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.
Response Format
Responses from the server will have the form
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 0 Message: Registration successfully completed domain: example suffix: uk.com registrant: Example Company Ltd chandle: H12345 thandle: H12345 bhandle: 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 chandle, thandle and bhandle fields either confirm the use of an existing handle or identify the handle created.
The amount field indicates the cost of the registration (excluding VAT).