Official Joke API with Multi-Language Support

This is a fork of the Official Joke API originally created by 5Dkatz. The fork, osman-koc/joke_api, adds multi-language support.

Endpoints:

Grab a random joke!

• Turkish:
  • /random_joke?lang=tr
• English:
  • /random_joke?lang=en

Grab ten random jokes!

• Turkish:
  • /random_ten?lang=tr
  • /random_joke?lang=tr
• English:
  • /random_ten?lang=en
  • /random_joke?lang=en

Grab jokes by type!

The endpoints are jokes/:type/random or jokes/:type/ten. For example:

• Turkish:
  • /jokes/bilmece/random?lang=tr
• English:
  • /jokes/programming/random?lang=en

Grab joke by id!

Use endpoint /jokes/:id

---

How these jokes were collected

The majority of these jokes were contributed by joke-loving coders around the world!

Make a contribution!

To contribute, please follow these steps:

1. Submit a Pull Request with your joke.
2. Determine the language for your joke: Turkish (tr) or English (en).
3. Add your joke to the respective JSON file:
   • If your joke is in Turkish, add it to jokes/tr.json.
   • If your joke is in English, add it to jokes/en.json.

Make sure your joke is in the following format:

{
  "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/random_joke or localhost:3005/random_ten on your browser!