FSJA API Description

This is the official FSJA (Frolicsome Santa Jokes API) provided by a couple of crazy Elves.

Register new User

To use this API you have to register with username / password first.

POST /fsja/register

Example:

curl -s -X POST -H 'Content-Type: application/json' http://whale.hacking-lab.com:10101/fsja/register --data '{"username":"testuser", "password": "passwordpassword"}'

Login as User (get a token)

With this method you will get a token to access the api. The token is valid for 1h, then you need to get a new token.

POST /fsja/login

Example:

curl -s -X POST -H 'Content-Type: application/json' http://whale.hacking-lab.com:10101/fsja/login --data '{"username":"testuser", "password": "passwordpassword"}'

Get a Joke

With a valid token you can get a random santa joke.

GET /fsja/random

Example:

curl -X GET "http://whale.hacking-lab.com:10101/fsja/random?token=[your token]"