Page 1 of 2

ManiaCalendar - API

Posted: 12 May 2015, 09:03
by toffe
Click here for the topic about ManiaCalendar itself.

Along with the Calendar itself we created an API for using on your own site's. You can display the dates of your event on your website.

The current API has basic features:
  • Get events, update events.
  • Search for upcoming dates.
  • Add, edit and delete event dates. (v2 only)
  • Add and delete event admins. (v2 only)
  • Get single event with details.
  • Get dates for an event.
  • Get styles (filter on title). (v1 only)
  • Get titles. (v1 only)
There are currently two verisons of the API:
- Version 1, Deprecated. Also the subdomain is deprecated.
- Version 2, New since 18-08-2017.

Documentation and Keys
More information about the versioning, api keys and (swagger) documentation can be found here:
For using the API you need to login with ManiaConnect and get a key. You can obtain the key on the same site.

SDK for PHP (DEPRECATED) (Version 1 only)
The PHP SDK is available now, installing using composer is recommended:

Code: Select all

composer require 'tomvlk/maniacalendar-php-sdk:dev-master'
Or stick to a version by replacing dev-master to any version.

Github page for the SDK:

For questions or suggestions reply or send a PM if it's more key related (like higher request rate).


Re: ManiaCalendar - API

Posted: 16 May 2015, 12:55
by zocka
I would suggest a method to get the filter options. The API mentions a style ID for example.
Something that would return possible filters like style etc. in categories with name and ID - maybe the color used on the website - would be really nice imo.

Maybe even like

Code: Select all

filters: {
titles: [ ... ],
<titleId>: { styles: [ {id: ... , name: ... , color: ... } ] },
Would be less requests than /filters/<titleId> (could still be a valid endpoint though).

Re: ManiaCalendar - API

Posted: 16 May 2015, 17:59
by toffe
zocka wrote:I would suggest a method to get the filter options.
Indeed, thats in the planning, at the first place! I keep you updated!


Re: ManiaCalendar - API

Posted: 17 May 2015, 09:51
by toffe
I updated the API, added new methods to get Titles and Styles.


Re: ManiaCalendar - API

Posted: 28 May 2015, 19:27
by ReDiX
I have a problem !

When I use the API with my personnal server : no problem (ip :

BUT when i wish use the API with the PMC/WTC/TMPLUS server I cannot connect to api (ip :

For test, try to open this page :

My server cannot establish a connect HTTP to

Please, help me :) i would like use your api for get the next events on my titlepack TMPLUS.

:D :D :D :D :D

Re: ManiaCalendar - API

Posted: 28 May 2015, 19:30
by toffe
Hey, I opened the log's, cant find the ip starting with 5. in the logs.
Do you have command line access to the server? (e.g. ssh)?
Can you try to ping to the server (ping and show the output.

Re: ManiaCalendar - API

Posted: 28 May 2015, 19:31
by ReDiX

root@ns317863:.# ping
PING ( 56(84) bytes of data.
64 bytes from ( icmp_req=1 ttl=58 time=8.12 ms
64 bytes from ( icmp_req=2 ttl=58 time=8.00 ms
64 bytes from ( icmp_req=3 ttl=58 time=7.85 ms
64 bytes from ( icmp_req=4 ttl=58 time=8.02 ms

Re: ManiaCalendar - API

Posted: 28 May 2015, 19:34
by ReDiX
For fun,

I typed this command :
root@ns317863# lynx

And i stay block at this step : "Making HTTP connection to"

Re: ManiaCalendar - API

Posted: 28 May 2015, 19:44
by toffe
I will reply on your mail, this is specific issue, at least for now.

EDIT: Solved, was specific problem

Re: ManiaCalendar - API

Posted: 29 May 2015, 09:35
by gouxim
Kudos for the quality of your api docs. Out of curiosity, would you mind sharing the tools you are using ?

A small feedback: i was a little confused by the format of the parameters in the examples, eg.

Code: Select all

GET /events HTTP/1.1
I was wondering if the "?" was missing, or if it was a POST request and the verb was not the right one