{"info":{"_postman_id":"87799c51-6cf8-4b46-a1b0-3af1c016ba2b","name":"JokeAPI","description":"

A public API to deliver joy to the world!

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"6048123","collectionId":"87799c51-6cf8-4b46-a1b0-3af1c016ba2b","publishedId":"2s9XxsTv8Y","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2023-07-27T10:45:56.000Z"},"item":[{"name":"Random Joke","id":"9908dc7c-bc60-4f81-b2dc-66f704bd829a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/random/","description":"

Get a random joke from the Joke API

\n","urlObject":{"protocol":"http","port":"3000","path":["random",""],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"a6d4cc40-1e1e-446c-81dc-611c982fc247","name":"New Request","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3000/random/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"113"},{"key":"ETag","value":"W/\"71-VNBOQi/Xbnr7wXzgrcawCdOzIa0\""},{"key":"Date","value":"Thu, 27 Jul 2023 10:44:43 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 43,\n \"jokeText\": \"What did one ocean say to the other ocean? Nothing, they just waved.\",\n \"jokeType\": \"Wordplay\"\n}"}],"_postman_id":"9908dc7c-bc60-4f81-b2dc-66f704bd829a"},{"name":"Specific Joke","id":"79b97759-642c-46e5-bc16-d8871fdd1d5d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"

Responds with a single joke with the requested joke id.

\n

Provide the joke id as a path parameter.

\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"73740aaa-d33f-475f-930f-3cb0e5b86285","name":"New Request","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://localhost:3000/jokes/:id","protocol":"http","host":["localhost"],"port":"3000","path":["jokes",":id"],"variable":[{"key":"id","value":"2"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"116"},{"key":"ETag","value":"W/\"74-kA23G2G3Kf4yOO14k9OQqvGxCNg\""},{"key":"Date","value":"Thu, 27 Jul 2023 11:03:15 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 2,\n \"jokeText\": \"Why did the scarecrow win an award? Because he was outstanding in his field.\",\n \"jokeType\": \"Puns\"\n}"}],"_postman_id":"79b97759-642c-46e5-bc16-d8871fdd1d5d"},{"name":"Filtered Joke By Type","id":"d59e8a86-d0a5-406c-9d18-941879ceb5cd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"

Filters all the jokes by their joke type.

\n

Provide a query parameter for type and if the type exists, then you should get back all the jokes that match that type.

\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"54d00049-92f9-40ff-a09b-bcb2eb2ad221","name":"New Request","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://localhost:3000/filter?type=Puns","protocol":"http","host":["localhost"],"port":"3000","path":["filter"],"query":[{"key":"type","value":"Puns"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"2028"},{"key":"ETag","value":"W/\"7ec-yn5L0jBzbhpr0AjIJLwzjXXXPJ4\""},{"key":"Date","value":"Thu, 27 Jul 2023 10:57:19 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 2,\n \"jokeText\": \"Why did the scarecrow win an award? Because he was outstanding in his field.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 3,\n \"jokeText\": \"I told my wife she was drawing her eyebrows too high. She looked surprised.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 7,\n \"jokeText\": \"Why don't some couples go to the gym? Because some relationships don't work out.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 16,\n \"jokeText\": \"I told my wife she was drawing her eyebrows too high. She looked surprised.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 20,\n \"jokeText\": \"Why don't some couples go to the gym? Because some relationships don't work out.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 29,\n \"jokeText\": \"I told my wife she was drawing her eyebrows too high. She looked surprised.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 33,\n \"jokeText\": \"Why don't some couples go to the gym? Because some relationships don't work out.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 42,\n \"jokeText\": \"I told my wife she was drawing her eyebrows too high. She looked surprised.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 46,\n \"jokeText\": \"Why don't some couples go to the gym? Because some relationships don't work out.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 55,\n \"jokeText\": \"I told my wife she was drawing her eyebrows too high. She looked surprised.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 59,\n \"jokeText\": \"Why don't some couples go to the gym? Because some relationships don't work out.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 68,\n \"jokeText\": \"I told my wife she was drawing her eyebrows too high. She looked surprised.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 72,\n \"jokeText\": \"Why don't some couples go to the gym? Because some relationships don't work out.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 81,\n \"jokeText\": \"I told my wife she was drawing her eyebrows too high. She looked surprised.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 85,\n \"jokeText\": \"Why don't some couples go to the gym? Because some relationships don't work out.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 94,\n \"jokeText\": \"I told my wife she was drawing her eyebrows too high. She looked surprised.\",\n \"jokeType\": \"Puns\"\n },\n {\n \"id\": 98,\n \"jokeText\": \"Why don't some couples go to the gym? Because some relationships don't work out.\",\n \"jokeType\": \"Puns\"\n }\n]"}],"_postman_id":"d59e8a86-d0a5-406c-9d18-941879ceb5cd"},{"name":"New Joke","id":"372386e5-5efb-40e3-80ca-5ee4633b43a5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"/jokes","description":"

Create a new joke to add into the bank of jokes.

\n

Need to provide body parameters for text and type.

\n

Joke ID will be autogenerated.

\n","urlObject":{"path":["jokes"],"query":[],"variable":[]}},"response":[{"id":"6def1f2f-977f-4241-adaf-f32a427a69c6","name":"New Request","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"text","value":"Iamonthemoonandthereisnowheretogetabeer. Thereisnospacebar.","type":"text"},{"key":"type","value":"Science","type":"text"}]},"url":"http://localhost:3000/jokes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"104"},{"key":"ETag","value":"W/\"68-tXEColDukjT9EWupiNWhhvIkYok\""},{"key":"Date","value":"Thu, 27 Jul 2023 11:34:43 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 101,\n \"jokeText\": \"Iamonthemoonandthereisnowheretogetabeer. Thereisnospacebar.\",\n \"jokeType\": \"Science\"\n}"}],"_postman_id":"372386e5-5efb-40e3-80ca-5ee4633b43a5"},{"name":"Replace Joke","id":"19083421-e8c0-4d6b-b28a-6dc85f08e812","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"/jokes/:id","description":"

Completely replace a joke based on the path parameter id specified.

\n

Provide the replacement values for the text and type.

\n","urlObject":{"path":["jokes",":id"],"query":[],"variable":[{"type":"any","value":null,"key":"id"}]}},"response":[{"id":"30b50df5-a484-45e5-bc2a-853d89e9a1a7","name":"Replace Joke","originalRequest":{"method":"PUT","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"text","value":"Why did the scarecrow win a prize? Because he was outstanding in his field.","type":"text"},{"key":"type","value":"Science","type":"text"}]},"url":{"raw":"http://localhost:3000/jokes/:id","protocol":"http","host":["localhost"],"port":"3000","path":["jokes",":id"],"variable":[{"key":"id","value":"2"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"118"},{"key":"ETag","value":"W/\"76-mng0cjGno2lwfK8NTHNjTKx+Eo4\""},{"key":"Date","value":"Thu, 27 Jul 2023 11:34:35 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 2,\n \"jokeText\": \"Why did the scarecrow win a prize? Because he was outstanding in his field.\",\n \"jokeType\": \"Science\"\n}"}],"_postman_id":"19083421-e8c0-4d6b-b28a-6dc85f08e812"},{"name":"Edit Joke","id":"fd3c524a-9f02-403d-b8db-1425e7f8ef29","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"url":"/jokes/:id","description":"

Edit a joke for the id that is specified in the path parameter.

\n

Provide optional values for either the text or the type.

\n","urlObject":{"path":["jokes",":id"],"query":[],"variable":[{"type":"any","value":null,"key":"id"}]}},"response":[{"id":"fd33c37c-1d24-48c2-8928-5337cb6c9dd7","name":"Edit Joke","originalRequest":{"method":"PATCH","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"Agriculture","type":"text"}]},"url":{"raw":"http://localhost:3000/jokes/:id","protocol":"http","host":["localhost"],"port":"3000","path":["jokes",":id"],"variable":[{"key":"id","value":"2"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"122"},{"key":"ETag","value":"W/\"7a-FZGuS7mThD9PEqji0swTUnN4xoE\""},{"key":"Date","value":"Thu, 27 Jul 2023 11:36:11 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 2,\n \"jokeText\": \"Why did the scarecrow win a prize? Because he was outstanding in his field.\",\n \"jokeType\": \"Agriculture\"\n}"}],"_postman_id":"fd3c524a-9f02-403d-b8db-1425e7f8ef29"},{"name":"A Joke","id":"5cfcfd0f-2f73-4e73-b5a0-e46dcba3eec1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"/jokes/:id","description":"

Delete a joke rfom the bank of jokes based on the path parameter provided for the joke id.

\n

Will return an error if no jokes match the provided id.

\n","urlObject":{"path":["jokes",":id"],"query":[],"variable":[{"type":"any","value":null,"key":"id"}]}},"response":[{"id":"ab748d56-c630-4f79-9e43-84202004f16b","name":"200","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"http://localhost:3000/jokes/:id","protocol":"http","host":["localhost"],"port":"3000","path":["jokes",":id"],"variable":[{"key":"id","value":"2"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"text/plain; charset=utf-8"},{"key":"Content-Length","value":"2"},{"key":"ETag","value":"W/\"2-nOO9QiTIwXgNtWtBJezz8kv3SLc\""},{"key":"Date","value":"Thu, 27 Jul 2023 11:42:07 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"OK"},{"id":"7574ec9d-fa34-468d-b01f-201e97e33827","name":"404","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"http://localhost:3000/jokes/:id","protocol":"http","host":["localhost"],"port":"3000","path":["jokes",":id"],"variable":[{"key":"id","value":"150"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"63"},{"key":"ETag","value":"W/\"3f-aKjNOF/Esr+rghltGRu5a8Rf5yg\""},{"key":"Date","value":"Thu, 27 Jul 2023 11:42:21 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Joke with id: 150 not found. No jokes were deleted.\"\n}"}],"_postman_id":"5cfcfd0f-2f73-4e73-b5a0-e46dcba3eec1"},{"name":"All Jokes","id":"dde1eab8-b2c0-4296-a2ee-12b969601430","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"/jokes/all","description":"

Delete all jokes in the bank.

\n

DANGER.

\n

Authentication:

\n

Requires the admin key to perform this action.

\n","urlObject":{"path":["jokes","all"],"query":[],"variable":[]}},"response":[{"id":"3dc77f60-bac8-4248-acab-647d0e91df30","name":"New Request","originalRequest":{"method":"DELETE","header":[],"url":"http://localhost:3000/all"},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"text/plain; charset=utf-8"},{"key":"Content-Length","value":"2"},{"key":"ETag","value":"W/\"2-nOO9QiTIwXgNtWtBJezz8kv3SLc\""},{"key":"Date","value":"Thu, 27 Jul 2023 11:43:07 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"OK"}],"_postman_id":"dde1eab8-b2c0-4296-a2ee-12b969601430"}]}