Version 2.3.0 - The Safe Mode Update
The most notable changes are:
- JokeAPI now has its own domain
jokeapi.dev
- The API should be called at the new base URL
https://v2.jokeapi.dev/
- Using just
jokeapi.dev
(without the "v2") is not recommended. Only use it to read and link to the documentation. - The old URL (
https://sv443.net/jokeapi/v2
) will still work until version 3.0 is released.
- The API should be called at the new base URL
- There is now a safe mode. It allows blocking out all potentially explicit jokes for sensitive applications like Discord Bots.
- It is enabled by adding the value-less URL parameter
?safe-mode
- It is enabled by adding the value-less URL parameter
- Added the new flag
explicit
to every joke. It indicates a joke that contains explicit language (swear words). - Added a new URL parameter
?dry-run
to enable testing a joke submission without actually submitting it to the API. - Increased rate limiting budgets to 120 when using GET and 5 when using POST/PUT.
- Made a lot of changes to how the documentation works and is structured.
- Changelog is now in markdown format.
- Added two more wrapper libraries for Node.js/TS and for Golang.
- JokeAPI now has category aliases. These are alternative names to the normal joke categories. More info here.