Page 1 of 2
ManiaCalendar - API
Posted: 12 May 2015, 09:03
by toffe
ManiaCalendar
Click here for the topic about ManiaCalendar itself.
API
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:
https://maniacalendar.com/my/api
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:
https://github.com/tomvlk/maniacalendar-php-sdk
For questions or suggestions reply or send a PM if it's more key related (like higher request rate).
Toffe
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
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 : 176.31.123.16)
BUT when i wish use the API with the PMC/WTC/TMPLUS server I cannot connect to api (ip : 5.135.165.229)
For test, try to open this page :
http://api.maniacalendar.com/v1/events?key=XXX
My server cannot establish a connect HTTP to api.maniacalendar.com.
Please, help me
i would like use your api for get the next events on my titlepack TMPLUS.
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 api.maniacalendar.com) and show the output.
Re: ManiaCalendar - API
Posted: 28 May 2015, 19:31
by ReDiX
Hey,
root@ns317863:.# ping api.maniacalendar.com
PING api.maniacalendar.com (81.4.106.77) 56(84) bytes of data.
64 bytes from s.tvalk.net (81.4.106.77): icmp_req=1 ttl=58 time=8.12 ms
64 bytes from s.tvalk.net (81.4.106.77): icmp_req=2 ttl=58 time=8.00 ms
64 bytes from s.tvalk.net (81.4.106.77): icmp_req=3 ttl=58 time=7.85 ms
64 bytes from s.tvalk.net (81.4.106.77): 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
http://api.maniacalendar.com/v1/events?key=XXXXXXXX
And i stay block at this step : "Making HTTP connection to api.maniacalendar.com"
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.
http://api.maniacalendar.com/doc/events#events1:
I was wondering if the "?" was missing, or if it was a POST request and the verb was not the right one