cadey
/
ponyapi
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
Please don't submit pull requests or patches here
19 Commits 2 Branches 1 Tag 202 KiB
HTML 54.4%
Java 21.3%
Nim 12.8%
Python 5.4%
Go 4.7%
Other 1.3%
Go to file
Christine Dodrill 2186367ab1 Update for new episode 2015-08-11 09:23:02 -07:00
client Add skybot plugin 2015-08-09 16:24:41 -07:00
.dockerignore Initial commit 2015-08-09 12:51:43 -07:00
.gitignore Initial commit 2015-08-09 12:51:43 -07:00
Dockerfile Initial commit 2015-08-09 12:51:43 -07:00
LICENSE Initial commit 2015-08-09 12:51:43 -07:00
Procfile Initial commit 2015-08-09 12:51:43 -07:00
README.md update readme 2015-08-09 14:35:13 -07:00
fim.list Update for new episode 2015-08-11 09:23:02 -07:00
ponyapi.py Add /newest route and document it 2015-08-09 14:09:24 -07:00
requirements.txt Initial commit 2015-08-09 12:51:43 -07:00

README.md

PonyAPI

A simple API for episodes of My Little Pony: Friendship is Magic to be run inside a container.

API Usage

An episode will have the following data type:

{
      "air_date": 1286735400,
      "episode": 1,
      "is_movie": false,
      "name": "Friendship is Magic Part 1",
      "season": 1
}

This represents Season 1, Episode 1 of My Little Pony: Friendship Is Magic. The air_date column represents the date and time that the episode was originally shown on The Hub (now Discovery Family Network). If is_movie is set and the season number is 99, the episode record should be treated as a movie.

Usage Limits

None. Don't make the server it's running on crash and we'll all be good.

Clients

Routes

The canonical route base for PonyAPI is http://ponyapi.apps.xeserv.us. Example usage:

$ curl http://ponyapi.apps.xeserv.us/season/1/episode/1
{
  "episode": {
    "air_date": 1286735400,
    "episode": 1,
    "is_movie": false,
    "name": "Friendship is Magic Part 1",
    "season": 1
  }
}

/all

Returns all information about all episodes. This returns an array of Episode objects as defined above.

/newest

Returns the episode of My Little Pony: Friendship is Magic that will air next.

/season/<number>

Returns all information about episodes in the given season number or a 404 reply if no episodes could be found. To get all information about the movies shown, set the season as 99.

/season/<number>/episode/<number

Returns all information about the episode with the given season and episode number. If the episode cannot be found, this will return a 404.

/random

Returns a random episode record from the list of episodes.

/search

This must be given a query paramater q containing the text to search for. Not including this will return a 406 reply. This will search the list of episode records for any episodes whose names match the given search terms. This is case-insensitive. If no episodes can be found, this will return a 404 reply.