Skip to content

kypeli/scala-comic-server

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
app
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Scala Comic Server

The Scala Comic Server is written in Scala [duh] using Play 2.1 to serve meta data in JSON format about comics from around the web. It's intended to be used as a backend server for a client application.

Supported comics

The following comics are currently supported:

How it works

The server will serve data about the comics in JSON format so that a client can show the most recent strip of a given comic. The server itself does not serve images nor store any images.

The JSON data will be cached for 60 minutes on the Scala Comic Server after which the comic information is fetched again and updated from the remote comic web server. This way the most recent comic strip is available to the client within 60 minutes after it's being published on the website.

As specified above, some comics are regional and will only be listed for people coming from those countries. By default, and if not specified above, the comic is served to everyone. Thus, the server does a reverse geolocation lookup on the client's IP address to find out from which country the request originates from.

REST APIs

The server has the following REST APIs.

  • /list - returns a list of available comics for the client to show to the user. JSON response:
      {
         "comics": [
            {
                "comicid": "sf",
                "name": "Sinfest"
            },
            ...
            {
                "comicid": "uf",
                "name": "UserFriendly"
            }
         ]
      }
  • /comic?id=[comicid] - returns information about a specified comic. JSON response for comicid=sf
      {
         "id": "sf",
         "name": "Sinfest",
         "url": "http://sinfest.net/comikaze/comics/2013-07-20.gif"
      }

Wanna try it right away?

The server is up and running without authentication, so go ahead and use the following REST APIs now:

NOTE: The server is for evaluation purposes only and is operating on a best effort principle. It's not guaranteed that the server will be up at any specifiec moment.

Clients

The following clients use this server already:

TODO

The server is not complete. I am also looking forward to contributions if you find that some comic should be supported but it's not, or if you can improve the code in some other ways.

Here are some things that I should do at some point:

  • Add more information about the comics, like when they were published.
  • PhD Comics is actually still served from my old server because issues in the Windows Phone client that I have.

License

The code for the server is licensed under the GPLv2 license.

About

Comic Server is written in Scala using Play2 to serve meta data about comics from around the web. It's intended to be used as a backend server for a client application.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages