karljoke
karljoke copied to clipboard
eklavyadev
A free and open-source API to fetch dad-jokes
KarlJoke
NOTE:- OUTDATED API, CURRENTLY INACTIVE. PLEASE MOVE TO https://github.com/15Dkatz/official_joke_api
A free and open-source API to fetch dadjokes
Inspired from https://github.com/15Dkatz/official_joke_api
Since the creators are not accepting PRs' and also the server is unavailable, we have a new system in place as an alternative 🚀
Public Endpoints
Get a random joke
GET /jokes/random
Get ten random jokes
GET /jokes/ten
Get number of random jokes
GET /jokes/{number}
| Parameter | Type | Description |
|---|---|---|
number |
int |
Required. Number of jokes to fetch |
Get random joke by type
GET /jokes/{type}/random
| Parameter | Type | Description |
|---|---|---|
type |
string |
Required. Category of joke |
Get number of random jokes by type
GET /jokes/{type}/{number}
| Parameter | Type | Description |
|---|---|---|
type |
string |
Required. Category of joke |
number |
int |
Required. Number of jokes to fetch |
Authors
Contributing
Contributions are always welcome!
Implement jokes.json with this structure
},
{
"id": last joke id + 1,
"type": "Your category here",
"setup": "Your joke here",
"punchline": "Your punchline here"
}
Please adhere to this project's code of conduct.
Run Locally
Clone the project
git clone https://github.com/eklavyadev/karljoke.git
Go to the project directory
cd karljoke
Install dependencies
npm install
Start the server
npm run start
eklavyadev