domreg($domain, $terms) : Domain registration
To register a domain you need to supply the definition of the
domain and a copy of our terms and conditions of business.
| Arguments to domreg() |
|---|
| Argument | Description |
|---|
| domain data |
| Key |
Description |
| domain |
Name of domain to register |
| org |
Registrant's identifier |
| admin |
Admin. contact's identifier |
| bill |
Billing contact's identifier |
| tech |
Technical contact's identifier |
| rr |
Array of resource records (see domain editing) |
| ns |
Array of nameservers (see domain editing) |
|
| terms |
AdamsNames terms and conditions of business: registrations
are accepted on the understanding that you accept these. |
| Hash returned by domreg() |
|---|
| Hash Key | Description |
|---|
| error |
An array of error messages which may include:
| Code | Description |
|---|
| 301 | Invalid terms |
| 310 | Invalid argument format |
| 320 | Domain definition not valid |
| 321 | Domain not found |
| 322 | Contact not found |
| 323 | Domain is already registered |
| 400 | Updates modified before edit |
| 500 | Fatal error in query |
| 510 | Fatal error in query |
|
| id |
The domain's identifier |
Examples
In the example below, our terms and conditions of business are not
reproduced in full. Rather they're truncated to 'TERMS AND
CONDITIONS...'. You can download the
full version.
A request
domreg(
{
'domain' => 'xmlrpcdemo998953.tc',
'org' => 'adams997r',
'admin' => 'adams397j',
'bill' => 'adams101s',
'tech' => 'adams191b'
},
' TERMS AND CONDITIONS...')
<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
<methodName>domreg</methodName>
<params>
<param>
<value>
<struct>
<member>
<name>org</name>
<value><string>adams997r</string></value>
</member>
<member>
<name>domain</name>
<value><string>xmlrpcdemo998953.tc</string></value>
</member>
<member>
<name>bill</name>
<value><string>adams101s</string></value>
</member>
<member>
<name>admin</name>
<value><string>adams397j</string></value>
</member>
<member>
<name>tech</name>
<value><string>adams191b</string></value>
</member>
</struct>
</value>
</param>
<param>
<value><string> TERMS AND CONDITIONS...</string></value>
</param>
</params>
</methodCall>
A successful reply
{
'id' => 'xmlr5196s',
'error' => []
}
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>error</name>
<value>
<array><data/></array>
</value>
</member>
<member>
<name>id</name>
<value><string>xmlr5196s</string></value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
An unsuccessful reply
{
'error' => [
[
323,
'Domain xmlrpcdemo998953.tc is already registered'
]
]
}
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>error</name>
<value>
<array>
<data>
<value>
<array>
<data>
<value><int>323</int></value>
<value><string>Domain xmlrpcdemo998953...</string></value>
</data>
</array>
</value>
</data>
</array>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
|
![[AdamsNames]](/images/adamsnames.gif)
