API Overview

Go to API Endpoints

Technology Overview

api.VideoMania.xxx is a RESTful API on HTTP requests and JSON responses. If you are familiar with Twitter, Facebook or other services API, you will feel comfortable using this one.

Current API Version

Version: 1.2.0

EndPoints

The API is accessed by making HTTP request to an endpoint URL in which GET or POST variables contain information about what you wish to access. Every endpoint is accessible via standard HTTP (port 80) http://api.videomania.xxx

Authentication

Most of the methods don't require authentication. Some methods may require you authenticate to get access to the data

Rate Limit

All requests are throttled by IP or consumer_url at a defined requests per minute. If you exceed the threshold in a given minute, you will receive an http error 420 and unable to make more requests untils your throttle is lifted. The time when you will be able to make more request will also be provided. But at this time, you can make as many requests as you want

Response Formats

All responses are returned in JSON

Responses

All requests return a JSON response with two keys: 'status' which contains the response information, and 'response' which contains the data of the results

Errors

The easiest way to check if there was in error is to check the status code. If it's anything other than 200, then an error occurred