You are here: Developers > OpenX Platform API

OpenX Platform API

Last updated on October 18, 2017

The OpenX Platform API is a JSON-based REST API which allows you to communicate with the OpenX Platform.

For developers who plan to integrate their applications with OpenX, this topic explains the basics of using the OpenX Platform API.

Getting support

If you have any technical questions that cannot be answered by our documentation, please contact OpenX through one of the following means:

Contact method Details
Internet

Go to the OpenX Community to access additional support:

  • Search answers to related questions.
  • Ask your question to a community of peers.
  • Log a support ticket directly with our support team.
Telephone

Use one of the following telephone numbers to speak direct directly to a support representative:

  • From Europe or Africa, call +442034687417 (UK).
  • From the US or anywhere else in the world, call toll-free 1-800-957-8275 (US only) or call 1-626-466-1145.

Authenticating users

Authenticating users involves four steps.

  1. Request an unauthorized request token.
  2. Authorize the user.
  3. Request an access token.
  4. Use the access token to access protected resources.

You can complete user authentication using one of two methods:

  • Browser-based authentication. Use browser-based authentication if you provide an interactive web-based login form for users, other than yourself.

  • Programmatic authentication. Use programmatic authentication if you access protected OpenX resources with your own credentials and do not provide a web-based login form for other users.

Making requests

When making an API request, you must follow standard HTTP API request structure. This ensures the request is properly formatted.

Request format

method base_URI/resource/identifier?parameter&parameter
Parameter Description
method

HTTP method.

Example: GET

base_URI

OpenX server name or admin hostname. This is the same URI used to log into the OpenX UI.

Example: http://PUBLISHER-ui.openx.net/ox/4.0/

resource

API object or service.

Example: report

identifier

UID, ID, or request for specific values.

Example: run

Note: An identifier is not required for all objects or services. Refer to the specific object or service for more information.

parameter

Specific additional request information. The first parameter must begin with a question mark (?). Each subsequent parameter must begin with an ampersand (&).

Example: ?report=inv_perf_pub&start_date=0

The OpenX Platform API returns standard JSON responses to all standard HTTP API requests.

Feedback form