API General Howto

From Openprovider API documentation

Revision as of 16:23, 19 December 2012 by WikiSysop (Talk | contribs)
Jump to: navigation, search

Contents

API server

API commands should be sent over SSL to our API server on https://api.openprovider.eu. Each API command is an XML string that contains the data required for the respective command. 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.

The API will return an XML string to the sender, indicating the result of the command and optionally additional information.

Authentication

Each API call requires authentication, in the form of a username and a password (plain text or hashed). The password hash can be found in the respective contact's details page in the reseller control panel. More information in the ApiAuthentication section.

PHP class for easy API inclusion

For easy integration in your existing system, Openprovider provides an example implementation in the PHP programming language. Other languages will follow in the future. The code provided consists of a wrapper class and an example implementation:

A more elaborated example is the following ZIP file, that contains a basic set of HTML forms that can be used to start your own online domain order form. Documentation is in the code, be sure to edit the config file before using the scripts. Note that the script will send registration requests realtime to your Openprovider account!

Other programming languages

In any other programming language, you can call the API by setting up a secured connection to https://api.openprovider.eu, and send the XML command over this connection. You will have to construct the XML command, and parse the XML response yourself.

Examples of the various API calls can be found in the description for each command. Note that the examples are nicely formatted, although you should send the XML without spaces and newlines to the Openprovider API!

Views
Personal tools