The PHP SDK is a relatively straightforward encapsulation of the Secure-eBook XML API.

The definition for all SDK error codes can be found here:

• Secure-eBook SDK Error Codes

Download PHP SDK v1.1.0

In order to use the object, you must download the API and include the SDK in your PHP project.

Example

  // Include the PHP SDK.  Make sure the specified path fits your custom configuration.
  require_once('sebSDK.php');

The SDK is encapsulated in a simple to use class. The class name is SebSDK.

function SebSDK($vendorCode, $sdkKey, $testMode = false, $sdkURL = false)
  ...

Example

// Create a SDK instance for account ADMI4176 in test mode.
$sdk = new SebSDK("ADMI4176", "a#$%^#6vkl3", true);

The SDK allows you to request multiple keys and links in one transaction. This is done through the request method of the SebSDK class. Whether keys, links or both are returned is based in the product's configuration in its linked Secure-eBook account.

function request($products, $secureebookproductcode = true, $userdata = false, $orderinfo = false)

Example

$keys = $sdk->request(
  array('TEST', array('TEST2', 2)),  // Request one key for book 'TEST' and two keys for book 'TEST2'
true,                               // Uses the Secure-eBook product's code.    
'order1',                          // Our system labels this order as 'order1', which will be stored on the Secure-eBook server.
   array('name' => 'John Doe',       // We also send the client's name and email address.
	 'email' => 'johndoe@nowhere.com')
  );

If all goes well, the request method returns an array containing activation keys and/or download links. However, if something goes wrong, it will return false. Error codes and messages can be retrieved through the SebSDK class' last_error and last_error_id fields.

Example

if ($res === false)  // triple equal makes sure that we are really looking for 'false'
{
  echo "Error " . $sdk->last_error . " (" . $sdk->last_error_id . "}";
}

The request method returns an associative array (map) containing keys and warnings.

The keys returned by the request method are stored in an array. This array is obtained by accessing the 'keys' value of the returned results.

The elements of this array are associative arrays in which the following values have been set:

Since Secure-eBook does not send emails for transactions that go through the SDK system, we strongly suggest that all proper activation and troubleshooting information is given to customers.

The activation guide can be found here: http://secure-ebook.com/help/ebook_activation
Troubleshooting guide can be found here: http://secure-ebook.com/help/ebook_activation_assistance

The links returned by the request method are stored in an array. This array is obtained by accessing the 'links' value of the returned results.

The elements of this array are associative arrays in which the following values have been set:

Since Secure-eBook does not send emails for transactions that go through the SDK system, we strongly suggest that all proper activation and troubleshooting information is given to customers.

The activation guide can be found here: http://secure-ebook.com/help/ebook_activation
Troubleshooting guide can be found here: http://secure-ebook.com/help/ebook_activation_assistance

The warnings returned by the request method are stored in an array. This array is obtained by accessing the 'warnings' value of the returned results.

The elements of this array are associative arrays in which the following values have been set:

if ($res === false)  // triple equal makes sure that we are really looking for 'false'
{
  echo "Error " . $sdk->last_error . " (" . $sdk->last_error_id . "}";
}
else
{  
   if ( $res['keys'] )
   {
      foreach($res['keys'] as $key)
      {
         echo $key['productcode'] . ' = ' . $key['key'] . '<br/>';
      }
   }
 
   // Generated links are returned here
   if ($res['links'])
   {
     foreach($res['links'] as $link)
     {
       echo "Link <strong>" . $link['url'] . "</strong> for <em>" . $link['productcode'] . "</em><br/>";
     }
   }
 
   if ( $res['warnings'] )
   {
      foreach($res['warnings'] as $warning)
      {
          echo $warning['productcode'] . ' = ' . $warning['messageid'] . '<br/>';          
	  echo $warning['text'] . "<br/>";
      }
   }	
}

• Allowing Proxy Settings through PHP SDK

^{PHP SDK Version History}