This method doesn’t actually do anything

Parameters

None

Response

Just sends back yo momma

Status: 200 OK { "joke": "Yo momma" }

No purpose for this method tbh.

This method returns a random joke (or jokes)

Parameters

count: Returns count number of jokes. Optional Default value: 1

Example:

/jokes?count={count}

Response

JSON Response of random joke(s)

If no count parameter is given:

Status: 200 OK { "joke": "Yo momma is so poor that she has to take the trash IN." }

If count parameter is given as 3:

Status: 200 OK [ { "joke": "Yo momma is so ugly that she gives Freddy Kreuger nightmares." }, { "joke": "Yo momma is twice the man you are." }, { "joke": "Yo momma is like the new AOL 4.0: Fun, Fast, Easy and Free!" } ]

For invalid count parameter:

Status: 404 NOT FOUND { "detail": "Invalid count paramter" }

This method returns a specific joke based on index in jokes.json

Parameters

index: Returns joke of the given index. Required

Example:

/jokes/20

Response

JSON Response of indexed joke

If index is given as 300:

Status: 200 OK { "joke": "Yo momma is like a bag of potato chips, 'Free-To-Lay.'" }

For invalid index parameter:

Status: 404 NOT FOUND { "detail": "Invalid index paramter" }

If you put query as “yo momma”:

Status: 200 OK { "results": "DONT" }

This method returns jokes based on search query

Parameters

query: String query to search Required

Example:

/search?query=money

Response

JSON Response of indexed joke

If index is given as 300:

Status: 200 OK { "results": [ "Yo momma is so ugly that people at the circus pay money not to see her.", "Yo momma is so stupid that she sold her car for gas money!", "Yo momma is so poor Nigerian scammers wire HER money!", "Yo momma is so poor that burglars break in and leave money." ] }

If no query parameter given:

Status: 422 UNPROCESSABLE ENTITY { "detail":[{"loc":["query","query"], "msg":"field required", "type":"value_error.missing"}] }