Access and Authentication
Home » Reseller Guides » Reseller API Guide » HTTP API

Access and Authentication

URL

The HTTP API is available at:

https://httpapi.com/

Note

For security reasons, you should always send API requests using HTTPS.

Authentication

All requests require the following authentication parameters:

  • auth-userid: Your Live Account Reseller Id (See the instructions below for finding your Reseller Id).

  • api-key: An alphanumeric code that can be used to authenticate your API calls (See the instructions below for finding your API Key),

    OR

    auth-password: The password you use to login to your Live Account's Reseller Control Panel.

    • Note

    It is recommended that you use the api-key instead of auth-password, since it is a more secure way of authenticating your API calls.

Locating your Reseller Id

  1. Login to your Reseller Control Panel. 1

  2. Click the icon at the top right corner of the page and then click Manage Profile.

  3. In the Reseller Profile Details view that is now displayed, the first field indicates your Reseller Id.

Locating your API Key

  1. Login to your Reseller Control Panel. 2

  2. In the Menu, point to Settings and then click API.

  3. Your unique API Key will be listed under the API Key section.

    You may generate a fresh API Key by clicking the icon and then confirming Key regeneration.

    Note

    Generating a fresh API Key will invalidate your old API Key immediately and this will have an impact on your existing API calls. Please exercise caution while generating a new API Key.

Whitelisting your IP Address(es)

  1. Login to your Reseller Control Panel. 3

  2. In the Menu, point to Settings and then click API.

  3. Under the Whitelist your IP Addresses section, specify the IP Addresses from where you will be making API requests and then click the Submit IPs button.

    Note

    IP ranges and netblocks are not accepted.

Testing / Trying out the API

The HTTP API requires that all requests to retrieve data should use the GET method and requests that submit, change, or destroy data should use the POST method. Requests that require a particular HTTP method will return an error if you do not make your request with the correct method.

However, to make it easy for you to try out and test the API using the browser or command line tools, we have made available a special Test URL that allows you to make any request using the GET method. Example Test URL requests are provided for all API requests.

The Test URL

https://test.httpapi.com/
Note

  • The Test URL should only be used for trying out or testing the API via the browser/command line tools and should not be used in production environments.

  • We always recommend usage of a Demo Account Reseller Id and Password with the Test URL for authentication as against usage of your Live Account credentials. Usage of your Live Account credentials, even with the Test URL, will result in actions being performed in production environments.

    Additional Information

    Sign up for a Demo Reseller Account