Jokes One API
Jokes One API offers a complete feature rich REST API access to its jokes platform. This is the documentation for the world famous [jokes…
Media & content#openapi#entertainment
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Jokes One API offers a complete feature rich REST API access to its jokes platform. This is the documentation for the world famous jokes API. If you are a subscriber and you are trying this from a console add 'X-JokesOne-Api-Secret' header and add your api key as the header value. You can test and play with the API right here on this web page. For using the private end points and subscribing to the API please visit https://jokes.one/api/joke/.
Endpoints 12
jod
- GETGET /jod
/jod?category=stringGets Joke of the Day. Optional category param determines the category of returned joke of the day - GETGET /jod/categories
/jod/categoriesGets a list of Joke of the Day Categories.
joke
- GETGET /joke
/joke?id=stringGets a Joke with a given id. - PUTPUT /joke
/joke?title=string&text=string&author=string&tags=stringAdd a new joke to your private collection. - DELETEDELETE /joke
/joke?id=stringDelete a joke. The user needs to be the owner of the joke to be able to delete it. - PATCHPATCH /joke
/joke?id=string&title=string&text=string&author=string&tags=stringUpdate a joke - GETGET /joke/categories/search
/joke/categories/search?query=string&start=0Gets a list of Joke Categories, based on a query term. - GETGET /joke/list
/joke/list?start=0Get the list of jokes in your private collection. - GETGET /joke/random
/joke/randomGets a Random Joke. When you are in a hurry this is what you call to get a random famous joke. - GETGET /joke/search
/joke/search?category=string&query=string&minlength=100&maxlength=300&author=string&private=falseSearch for a Joke in Jokes One platform. Optional category , author, minlength, maxlength params determines the filters applied while searching for the joke. - POSTPOST /joke/tags/add
/joke/tags/add?id=string&tags=stringAdd a tag to a given Joke. - POSTPOST /joke/tags/remove
/joke/tags/remove?id=string&tags=stringRemove a tag from a given joke.
API details
- Base URL
https://api.jokes.one- Authentication
- An API key in the X-JokesOne-Api-Secret header
- Operations
- 12 operations on 9 pathsGET 7POST 2PUT 1PATCH 1DELETE 1
- Main resources
- joke 10jod 2
- Response formats
application/jsapplication/jsonapplication/xml- Description format
- Swagger 2.0, API version
1.1 - Links
- OpenAPI document · Terms of service · Support
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the Jokes One API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Jokes One API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-JokesOne-Api-Secret header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “GET /jod” (GET /jod?category=string), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Jokes One API?
Jokes One API offers a complete feature rich REST API access to its jokes platform. This is the documentation for the world famous [jokes… It is listed under Media & content and has 12 endpoints.
Who publishes the Jokes One API?
It is listed from Jokes One's public API description (an OpenAPI document), not published by Jokes One on Swastik Codes. Anyone who controls jokes.one can claim the profile by adding a DNS TXT record.
What is the base URL of the Jokes One API?
Requests go to https://api.jokes.one. Endpoint paths are added to this base URL.
How do I authenticate with the Jokes One API?
With an API key in the X-JokesOne-Api-Secret header.
How many endpoints does the Jokes One API have?
12 operations on 9 paths (7 GET, 2 POST, 1 PUT, 1 PATCH, 1 DELETE). The largest groups are joke, jod.
Is forking the Jokes One API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.