API Module Authentication

From Openprovider API documentation

---

Revision as of 16:22, 19 December 2012

Contents 1 Authentication 2 Examples 2.1 Using PHP class 2.2 Raw XML

Authentication

Module	general
Command name	none
Use	Each API call requires authentication. This can be with a plain text password, or a password hash. To get the password hash, or to reset the password hash, please visit the reseller control panel, section contact details.
Input	username password (only required if no hash is provided) hash (only required if no password is provided)
Output	-

Examples

Using PHP class

// Plain text password
$request = new OP_Request;
$request->setCommand('createCustomerRequest')
 ->setAuth(array('username' => 'username', 'password' => 'password'))
 ->setArgs(array(
    ...
 ));

// Hashed password
$request = new OP_Request;
$request->setCommand('createCustomerRequest')
 ->setAuth(array('username' => 'username', 'hash' => '2e1b1611c1e1dba5174ad4cfd1f3b3bd6'))
 ->setArgs(array(
    ...
 ));

Raw XML

Please note that newlines and leading spaces are added only for readability. Those whitespaces should be excluded from your XML command before sending it to Openprovider.

// Plain text password
<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <credentials>
    <username>username</username>
    <password>password</password>
  </credentials>
  ...
</openXML>

// Hashed password
<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <credentials>
    <username>username</username>
    <hash>2e1b1611c1e1dba5174ad4cfd1f3b3bd6</hash>
  </credentials>
  ...
</openXML>