Difference between revisions of "Transfer"

From Boxis.net API Docs
Jump to: navigation, search
Line 6: Line 6:
 
{|
 
{|
 
|-
 
|-
| - '''domain'''::String::Domain name that you need to Transfer.
+
| - '''version''' (String)
 +
''API version (e.g. '1.0')''
 
|-
 
|-
| - '''auth-code'''::String::Authorization Code (a.k.a. Domain Secret) of the domain name that you want to transfer.
+
| - '''timestamp''' (String)
 +
''Sequence of characters, denoting the date and time (e.g '1336553826')''
 
|-
 
|-
| - '''ns'''::Array of Strings::List of Name Servers to be associated with the domain name. A maximum of 5 Name Servers can be specified.
+
| - '''username''' (String)
 +
''User e-mail address (e.g 'mail1@example.com')''
 
|-
 
|-
| - '''protect-privacy'''::Boolean::Enables / Disables the Privacy Protection setting for the domain name.
+
| - '''authcode''' (String)
 +
'' md5 hash consisting of the concatenation of timestamp and user_key (e.g md5(1336553826BX3KwWU2SuqvoEWnjYmOibf'))''
 
|-
 
|-
| - '''protection-lock'''::Boolean::Enable / Disable Protection Lock service. Possible values are: true or false.
+
| - '''section''' (String)
 +
''API module name. Use 'domains' value
 
|-
 
|-
| - '''auto-renewal'''::Boolean::Enable / Disable Auto-Renewal service. Possible values are: true or false.
+
| - '''action''' (String)
 +
''API module function. Use 'transfer' value
 +
|-
 +
| - '''domain''' (String)
 +
''Domain name that you need to transfer''
 +
|-
 +
| - '''auth-code''' (String)
 +
''Authorization Code (a.k.a. Domain Secret) of the domain name that you want to transfer''
 +
|-
 +
| - '''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''
 +
|-
 +
| - '''protection-lock''' (Boolean)
 +
''Enable / Disable Protection Lock service. Possible values are: true or false''
 +
|-
 +
| - '''auto-renewal''' (Boolean)
 +
''Enable / Disable Auto-Renewal service. Possible values are: true or false''
 
|}
 
|}
  
 
=== Output params ===
 
=== Output params ===
  
==== example in XML ====
+
==== Example in XML (Success) ====
 
+
===== success =====
+
  
 
<pre>
 
<pre>
Line 35: Line 57:
 
</pre>
 
</pre>
  
===== error =====
+
==== Example in XML (Error) ====
  
 
<pre>
 
<pre>
Line 47: Line 69:
 
</pre>
 
</pre>
  
==== Example in Json ====
+
==== Example in Json (Success) ====
 
+
===== success =====
+
  
 
<pre>
 
<pre>
Line 58: Line 78:
 
</pre>
 
</pre>
  
===== error =====
+
==== Example in Json (Error) ====
  
 
<pre>
 
<pre>
Line 66: Line 86:
 
  "timestamp":1335777400}
 
  "timestamp":1335777400}
 
</pre>
 
</pre>
 
==== Errors Descriptions ====
 
{|
 
|-
 
| - 'domain' is not valid
 
|-
 
| - there is no such tld
 
|-
 
| - 'years' value is not valid
 
|-
 
| - 'ns' could not be greater than five
 
|-
 
| - 'protect-privacy' value is not valid
 
|-
 
| - 'protection-lock' value is not valid
 
|-
 
| - 'autorenew' value is not valid
 
|-
 
| - domain 'testdomain.com' is not available
 
|-
 
| - domain not transfered
 
|}
 

Revision as of 20:32, 9 May 2012

Domain Function: Transfer

With this command, you are able to transfer your domain to 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 'transfer' value

- domain (String)

Domain name that you need to transfer

- auth-code (String)

Authorization Code (a.k.a. Domain Secret) of the domain name that you want to transfer

- 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

- protection-lock (Boolean)

Enable / Disable Protection Lock service. Possible values are: true or false

- auto-renewal (Boolean)

Enable / Disable Auto-Renewal service. Possible values are: true or false

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}