{"id":16225559,"url":"https://github.com/pitzzahh/jokes-api","last_synced_at":"2025-03-19T12:31:08.607Z","repository":{"id":63451245,"uuid":"567988744","full_name":"pitzzahh/jokes-API","owner":"pitzzahh","description":"API that generates random jokes","archived":false,"fork":false,"pushed_at":"2023-05-22T03:01:10.000Z","size":199,"stargazers_count":5,"open_issues_count":4,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T18:42:52.465Z","etag":null,"topics":["api","java","jokes-api","spring","spring-api"],"latest_commit_sha":null,"homepage":"https://jokes.araopj.tech","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pitzzahh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-11-19T04:55:05.000Z","updated_at":"2023-12-16T13:13:09.000Z","dependencies_parsed_at":"2024-10-27T20:33:47.349Z","dependency_job_id":"62833bd3-644f-4b29-aa1e-3ceed41277e0","html_url":"https://github.com/pitzzahh/jokes-API","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitzzahh%2Fjokes-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitzzahh%2Fjokes-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitzzahh%2Fjokes-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitzzahh%2Fjokes-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pitzzahh","download_url":"https://codeload.github.com/pitzzahh/jokes-API/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243989576,"owners_count":20379648,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","java","jokes-api","spring","spring-api"],"created_at":"2024-10-10T12:45:28.580Z","updated_at":"2025-03-19T12:31:06.130Z","avatar_url":"https://github.com/pitzzahh.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Jokes API\n\nAPI that generates random jokes based on some categories or just random\n___\n![GitHub Issues](https://img.shields.io/github/issues/pitzzahh/jokes-API)\n![Forks](https://img.shields.io/github/forks/pitzzahh/jokes-API)\n![Stars](https://img.shields.io/github/stars/pitzzahh/jokes-API)\n![License](https://img.shields.io/github/license/pitzzahh/jokes-API)\n![Forks](https://img.shields.io/github/forks/pitzzahh/jokes-API)\n![Stars](https://img.shields.io/github/stars/pitzzahh/jokes-API)\n![Contributors](https://img.shields.io/github/contributors/pitzzahh/jokes-API)\n![Last Commit](https://img.shields.io/github/last-commit/pitzzahh/jokes-API)\n![Code size](https://img.shields.io/github/languages/code-size/pitzzahh/jokes-API)\n![Top language](https://img.shields.io/github/languages/top/pitzzahh/jokes-API)\n![Languages count](https://img.shields.io/github/languages/count/pitzzahh/jokes-API)\n![Repo size](https://img.shields.io/github/repo-size/pitzzahh/jokes-API)\n___\n## API Reference\n\n#### Get a random joke and returns a JSON response from the API\n\n##### Temporary link\n- https://jokes-api-prod-production.up.railway.app\n\n```html\n GET https://jokes.araopj.tech/v1/random\n```\n\n#### Example response\n\n```json\n{\n  \"joke\": \"What do you call a fake noodle? An \\\"impasta\\\".\",\n  \"category\": \"DAD_JOKE\",\n  \"language\": \"ENGLISH\"\n}\n```\n```json\n{\n  \"joke\": \"Ano ang sabi ng isang kahoy sa ibang kahoy? Pakapit!\",\n  \"category\": \"ONE_LINER\",\n  \"language\": \"FILIPINO\"\n}\n```\n#### Get random joke based on category and language\n\n```html\n GET https://jokes.araopj.tech/v1/random?category=${category}\u0026language=${language}\n```\n\n| Parameter  | Type     | Description                             |\n|:-----------|:---------|:----------------------------------------|\n| `category` | `String` | **Required**. category of joke to fetch |\n| `language` | `String` | **Required**. language of joke to fetch |\n\n\n##### Sample Request\n\n```html\n GET https://jokes.araopj.tech/v1/random?category=ANY\u0026lang=FILIPINO\n```\n\n#### Get random joke based on category\n\n```html\n GET https://jokes.araopj.tech/v1/random?category=${category}\n```\n\n| Parameter  | Type     | Description                             |\n|:-----------|:---------|:----------------------------------------|\n| `category` | `String` | **Required**. category of joke to fetch |\n\n| Categories \u003cbr/\u003eavailable |\n|:--------------------------|\n| `ANY`                     |\n| `DAD_JOKE`                |\n| `PUN`                     |\n| `KNOCK_KNOCK`             |\n| `ONE_LINER`               |\n\n#### Sample Request\n\n```html\n GET https://jokes.araopj.tech/v1/random?category=DAD_JOKE\n```\n___\n\n#### Get random joke based on language\n\n```html\n GET https://jokes.araopj.tech/v1/random?language=${language}\n```\n\n| Parameter  | Type     | Description                             |\n|:-----------|:---------|:----------------------------------------|\n| `language` | `String` | **Required**. language of joke to fetch |\n\n\n| Languages \u003cbr/\u003eavailable |\n|:-------------------------|\n| `ENGLISH`                |\n| `FILIPINO`               |\n\n#### Sample Request\n\n```html\n GET https://jokes.araopj.tech/v1/random?lang=FILIPINO\n```\n___\n\n## Contributing\n\nContributions are always welcome!\n\n#### Have a joke in mind? Submit now!\n\n```html\n POST https://api.araopj.tech/api/v1/jokes/submit\n```\n\n##### Sample submission\n\n```json\n{\n  \"joke\": \"What do you call a cow with no legs? Ground beef.\",\n  \"category\": \"DAD_JOKE\",\n  \"language\": \"ENGLISH\"\n}\n```\n___\n\nSee `contributing.md` for ways to get started.\n\nPlease adhere to this project's `code of conduct`.\n\n___\n## Features\n- [x] Random joke\n- [x] Many joke categories\n- [x] Many joke languages\n- [x] Random joke based on category\n- [x] Random joke based on language\n- [x] Random joke based on category and language\n- [x] API Documentation\n- [ ] API Rate Limiting\n- [ ] API Authentication\n- [ ] API Key\n- [ ] Microservice (? maybe)\n___\n## Support\n\nFor support, email pitzzahh@araopj.tech\n___\n## License\n[MIT](https://choosealicense.com/licenses/mit/)\n\n### 🤍 Special Thanks to [railway](https://railway.app/) for providing free hosting for this project\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpitzzahh%2Fjokes-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpitzzahh%2Fjokes-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpitzzahh%2Fjokes-api/lists"}