Itortv external API

From ItortvWiki

Jump to: navigation, search

An API is available for developers who want to interact with users' info in itortv.

Our goal is to help users to locate and mantain the episodes of their favorite tv shows. All external apps should have this in mind, and it would be nice if they were created with that intention. Please, be aware that we are just a few developers that do this for fun, with no commercial interests, so please, act responsibly.

You must have a developer key to consume this API. Please, send us an email to contact@itortv.com [1] and we will email you one. If you want to tell us what you want it for, it would be great, but it is not required. We are also developers and we know that most of the time, APIs are just for having fun ;-)

This API is constantly evolving. Please, feel free to reach us and ask us for more at contact@itortv.com. We really love receiving emails!


API exposé (314)

The idea of the API is to make possible user interaction with his tv shows list. That means that the user has to be logged in so he can start consuming the API. So, the first request of an external application must be a LOGIN REQUEST.

A LOGIN REQUEST returns a session parameter, that identifies the user for the rest of the session. This parameter must be sent in next requests. If no request is done in a while (depending the server, it could be about 30 minutes), the server will not recognize the user session, and it will return a string starting with NOSESSION. It is a task of the application to check the result and guarantee a not-crashing-event when receiving this string.

Every request has to send a key parameter. This key is the API developer key that will be emailed to you.

Every request returns a JSON object.

The possible requests are listed next:

Applications

Personal tools