Difference between revisions of "Register"
From Boxis.net API Docs
Line 9: | Line 9: | ||
{| | {| | ||
|- | |- | ||
− | | - ''' | + | | - '''version''' (String) |
+ | ''API version (e.g. '1.0')'' | ||
|- | |- | ||
− | | - ''' | + | | - '''timestamp''' (String) |
+ | ''Sequence of characters, denoting the date and time (e.g '1336553826')'' | ||
|- | |- | ||
− | | - ''' | + | | - '''username''' (String) |
+ | ''User e-mail address (e.g 'mail1@example.com')'' | ||
|- | |- | ||
− | | - '''protect-privacy''' | + | | - '''authcode''' (String) |
+ | '' md5 hash consisting of the concatenation of timestamp and user_key (e.g md5(1336553826BX3KwWU2SuqvoEWnjYmOibf'))'' | ||
+ | |- | ||
+ | | - '''section''' (String) | ||
+ | ''API module name. Use 'domains' value | ||
+ | |- | ||
+ | | - '''action''' (String) | ||
+ | ''API module function. Use 'register' value | ||
+ | |- | ||
+ | | - '''domain''' (String) | ||
+ | ''Domain name that you need to register'' | ||
+ | |- | ||
+ | | - '''years''' (Integer) | ||
+ | ''Number of years for which you wish to register this domain name'' | ||
+ | |- | ||
+ | | - '''ns''' (Array of Strings) | ||
+ | ''List of Name Servers to be associated with the domain name. A maximum of 5 Name Servers can be specified'' | ||
+ | |- | ||
+ | | - '''protect-privacy''' (Boolean) | ||
+ | ''Enables / Disables the Privacy Protection setting for the domain name. Possible values are: 1 or 0' | ||
|} | |} | ||
=== Output params === | === Output params === | ||
− | ==== example in XML | + | ==== example in XML (Success) ==== |
− | + | ||
− | + | ||
<pre> | <pre> | ||
Line 34: | Line 54: | ||
</pre> | </pre> | ||
− | ==== | + | ==== example in XML (Error) ==== |
<pre> | <pre> | ||
Line 45: | Line 65: | ||
</return> | </return> | ||
</pre> | </pre> | ||
− | |||
− | ==== | + | ==== Example in Json (Success) ==== |
<pre> | <pre> | ||
Line 56: | Line 75: | ||
</pre> | </pre> | ||
− | ==== | + | ==== Example in Json (Error) ==== |
<pre> | <pre> | ||
Line 64: | Line 83: | ||
"timestamp":1335777400} | "timestamp":1335777400} | ||
</pre> | </pre> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Revision as of 20:28, 9 May 2012
Contents
Domain Function: Register
With this command, you are able to register your domain with boxis.net.
Input params
- version (String)
API version (e.g. '1.0') |
- timestamp (String)
Sequence of characters, denoting the date and time (e.g '1336553826') |
- username (String)
User e-mail address (e.g 'mail1@example.com') |
- authcode (String)
md5 hash consisting of the concatenation of timestamp and user_key (e.g md5(1336553826BX3KwWU2SuqvoEWnjYmOibf')) |
- section (String)
API module name. Use 'domains' value |
- action (String)
API module function. Use 'register' value |
- domain (String)
Domain name that you need to register |
- years (Integer)
Number of years for which you wish to register this domain name |
- ns (Array of Strings)
List of Name Servers to be associated with the domain name. A maximum of 5 Name Servers can be specified |
- protect-privacy (Boolean)
Enables / Disables the Privacy Protection setting for the domain name. Possible values are: 1 or 0' |
Output params
example in XML (Success)
<?xml version="1.0" encoding="UTF-8"?> <return> <result>1</result> <resulttxt>success</resulttxt> <params/> <timestamp>1335767184</timestamp> </return>
example in XML (Error)
<?xml version="1.0" encoding="UTF-8"?> <return> <result>0</result> <resulttxt>Error: {error description}</resulttxt> <params/> <timestamp>1335767184</timestamp> </return>
Example in Json (Success)
{"result":"1", "resulttxt":"success", "params":[], "timestamp":1335777400}
Example in Json (Error)
{"result":"0", "resulttxt":"Error: {error description}", "params":[], "timestamp":1335777400}