The Opt It Mobile API is included with your Opt It Mobile account. The information below will give you the foundation to start using the REST-based API.
First thing you will need to do is create an Opt It Mobile account. If you do not have an account, please sign up for an account first. This account will allow you to grant permissions necessary to access the Opt It Mobile API.
Once you have an Opt It Mobile account, you will need to grant the "Mobile API Access" role to your user inside your account in order to authenticate. You will use the username and password of this user as the crendetials for authentication. You can add this role by going to Account -> Manager Users and editing the user. Only users with this role can authenticate via the Opt It Mobile API. In addition, users with the Mobile API Access role can only access resources of the keywords they have been assigned. If an authenticated user tries to access a resource for keywords they do not have permissions, they will receive a 401 "Unauthorized" error.
All REST API calls require the user to authenticate via Basic Authentication. You must use a valid username and password and the user must have the Mobile API Access role assigned to them. Currently, this is the only authentication method that is supported.
The Opt It Mobile API follows the design principles of Representational State Transfer(REST). You can change the format in which you get results by changing the extenstion in your request. Currently, XML and JSON are supported for most methods, but please check each method call for specific details.
Certain API methods have an optional parameters that can be used to filter the result set. The parameters are specified with each method where appropriate. In addition, a page parameter can be used to page through results.
The Opt It Mobile API supports UTF-8 encoding. Please URL encode all parameters when making requests.
The Opt It Mobile API will return one of the following response codes with each request.
For requests that encounter an error, an error will be returned in your requested format. An XML error would be returned in the following format:<?xml version="1.0" encoding="UTF-8"?>
For additional support, visit our support page.
©2005-2011 Opt It, Inc. All rights reserved.