Searches jokes

GET /joke

By passing in the appropriate options, you can search for available jokes

Query parameters

  • pass an optional search string for looking up inventory

  • numberofJokes integer(int32)

    number of jokes to return

    Minimum value is 1. Default value is 25.

  • category string

    category of jokes to return

  • sortBy string

    Allowed: thumbsUp, thumbsDown, dateAdded.

  • Allowed: asc, desc. asc is ascending and sorts from A to Z. desc is descending and sorts from Z to A.

Responses

  • search results matching criteria

    Hide response attributes Show response attributes array[object]
    • id string Required

      The id of the Joke. Assigned when added.

    • joke string Required

      The lead-in to the joke.

    • punchline string Required

      This bit should make you laugh :).

    • category string Required

      the category of the joke.

    • thumbsUp integer Required

      Count of upvotes for the joke.

    • thumbsDown integer Required

      Count of down votes for the joke.

    • dateAdded string(date-time) Required
  • bad input parameter

GET /joke
curl \
 -X GET https://virtserver.swaggerhub.com/dougsillars/joke_api/1.0.0/joke
Response examples (200)
[
  {
    "id": "ce0b9fbe-7ad8-11eb-9439-0242ac130002",
    "joke": "Why did the chicken cross the road?",
    "punchline": "To get to the other side.",
    "category": "Classic",
    "thumbsUp": 2,
    "thumbsDown": 4,
    "dateAdded": "2016-08-29T09:12:33.001Z"
  }
]
Response examples (200)
[
  {
    "id": "ce0b9fbe-7ad8-11eb-9439-0242ac130002",
    "joke": "Why did the chicken cross the road?",
    "punchline": "To get to the other side.",
    "category": "Classic",
    "thumbsUp": 2,
    "thumbsDown": 4,
    "dateAdded": "2016-08-29T09:12:33.001Z"
  }
]