Javascript Menu by Deluxe-Menu.com

The Fastest and Easiest-to-Use Website Forms.                Guaranteed.

Best. Website Forms. Ever.

API Overview




Introduction

The Formexperts API is an interface for accessing your Formexperts account data using HTTP and XML. The API makes it easy to create web and desktop applications that integrate with your account.

Some potential application ideas:
  • Custom import tools (SalesForce, QuickBooks, Mailing Lists, etc.)
  • Integrate form data or statistics into your web site
  • External integration with other online services

To enable API access for your account, login to the Members Area and follow these steps:
  1. Select 'Edit My Account Info' from the right-hand menu
  2. Click the button marked 'Enable Formexperts API'

Service URL

The Formexperts API has a single point of entry:
https://secure.blueoctane.net/api/
Please note the use of https:// in the URL above. All API communication is encrypted over HTTPS. Any non-secure requests are automatically rejected.


Authentication

After enabling API access for your account, you'll be given a unique authentication token. For every API request you make, you'll need to present this token using basic HTTP authentication.

HTTP authentication traditionally takes a username/password pair, but since we're dealing with a single token, you'll only use the username field. If your HTTP library requires a password as well, just use an arbitrary string - like 'X'.

Keep this token secret. It should be guarded just as you would your regular account password. If you feel your token has been compromised, you can reset it by requesting a new token from the 'Edit My Account' page in the Members Area.


Representation Formats

Requests
All Formexperts API requests are delivered as an HTTP POST request to the endpoint URL.
  • Date and time values are submitted in of the form YYYY-MM-DD.
  • Date and time values are returned in of the form YYYY-MM-DD HH:MM:SS.
  • Booleans are either 1 (true) or 0 (false).
  • Fields denoting percentages are passed as whole values, not decimals (e.g. 5 for five percent).

Responses
Responses are available in the following formats:
  • XML

    Sample response:
    <?xml version="1.0" encoding="utf-8">
    <response status="ok">
      [return value(s) here]
    </response>

    All responses are wrapped in a top-level request element. The status attribute will let you know whether the request succeeded or failed. //

    In the case of a failure response, the response body will contain one or more error messages.
    <?xml version="1.0" encoding="utf-8">
    <response status="fail">
      <error> ... </error>
    </response>

  • Serialized PHP Array


  • To have the results returned a serialized PHP array, include the variable 'method' with a value of 'array' in your posted variables.

    unserialize( ) the returned string to an associative array, and then for debugging purposes - use the print_r( ) function to determine the format of the returned array's values.

    In the case of a failure response, the returned array will contain a key named 'error' with an explanation of the error.
    Please see the Sample Code section of the API documentation.





API Documentation


Home   |   Contact   |   Legal   |   Privacy   |   Members Area   |   Free Contact Form   |   Affiliate Program   |   Sitemap

©2017 Blue Octane Media, Inc. All rights reserved. Read Legal policy and Privacy policy.