15Dkatz / Official_joke_api
Official Joke API!
Stars: ✭ 427
Programming Languages
javascript
184084 projects - #8 most used programming language
Official Joke API
Endpoints:
Grab a random joke!
https://official-joke-api.appspot.com/random_joke
https://official-joke-api.appspot.com/jokes/random
Grab ten random jokes!
https://official-joke-api.appspot.com/random_ten
https://official-joke-api.appspot.com/jokes/ten
Grab jokes by type!
The endpoints are jokes/:type/random
or jokes/:type/ten
. For example:
https://official-joke-api.appspot.com/jokes/programming/random
https://official-joke-api.appspot.com/jokes/programming/ten
How these jokes were collected
The majority of these jokes were contributed by joke-loving coders around the world!
Make a contribution!
Submit a Pull Request, with your joke added to the jokes/index.json file. Make sure the joke is in this format:
{
"id": last joke id + 1,
"type": "programming",
"setup": "What's the best thing about a Boolean?",
"punchline": "Even if you're wrong, you're only off by a bit."
}
Run Locally
- Clone the repo
npm i && npm run dev
- Visit
localhost:3005/jokes/random
orlocalhost:3005/jokes/ten
on your browser!
Note that the project description data, including the texts, logos, images, and/or trademarks,
for each open source project belongs to its rightful owner.
If you wish to add or remove any projects, please contact us at [email protected].