{"id":21648021,"url":"https://github.com/eklavyadev/karljoke","last_synced_at":"2025-03-20T01:54:56.241Z","repository":{"id":46228853,"uuid":"407835172","full_name":"eklavyadev/karljoke","owner":"eklavyadev","description":"A free and open-source API to fetch dad-jokes","archived":false,"fork":false,"pushed_at":"2024-10-04T16:34:35.000Z","size":327,"stargazers_count":24,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-28T06:10:35.666Z","etag":null,"topics":["api","dadjokes","hacktoberfest","jokes"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/eklavyadev.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":"2021-09-18T10:58:34.000Z","updated_at":"2024-10-04T16:34:39.000Z","dependencies_parsed_at":"2025-01-25T05:11:18.195Z","dependency_job_id":"d544d35e-098c-497a-9f86-09fceb61c49e","html_url":"https://github.com/eklavyadev/karljoke","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eklavyadev%2Fkarljoke","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eklavyadev%2Fkarljoke/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eklavyadev%2Fkarljoke/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eklavyadev%2Fkarljoke/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eklavyadev","download_url":"https://codeload.github.com/eklavyadev/karljoke/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244536442,"owners_count":20468349,"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","dadjokes","hacktoberfest","jokes"],"created_at":"2024-11-25T06:52:58.005Z","updated_at":"2025-03-20T01:54:56.221Z","avatar_url":"https://github.com/eklavyadev.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\r\n# KarlJoke\r\nNOTE:- OUTDATED API, CURRENTLY INACTIVE. PLEASE MOVE TO https://github.com/15Dkatz/official_joke_api\r\n\r\nA free and open-source API to fetch dadjokes\r\n\r\nInspired from https://github.com/15Dkatz/official_joke_api\r\n\r\nSince the creators are not accepting PRs' and also the server is unavailable, we have a new system in place as an alternative 🚀\r\n\r\n\r\n## Public Endpoints\r\n\r\n#### Get a random joke\r\n\r\n```http\r\n  GET /jokes/random\r\n```\r\n#### Get ten random jokes\r\n\r\n```http\r\n  GET /jokes/ten\r\n```\r\n#### Get number of random jokes\r\n\r\n```http\r\n  GET /jokes/{number}\r\n```\r\n\r\n| Parameter | Type     | Description                       |\r\n| :-------- | :------- | :-------------------------------- |\r\n| `number`      | `int` | **Required**. Number of jokes to fetch |\r\n\r\n#### Get random joke by type\r\n```http\r\n  GET /jokes/{type}/random\r\n```\r\n| Parameter | Type     | Description                       |\r\n| :-------- | :------- | :-------------------------------- |\r\n| `type`      | `string` | **Required**. Category of joke |\r\n\r\n#### Get number of random jokes by type\r\n```http\r\n  GET /jokes/{type}/{number}\r\n```\r\n| Parameter | Type     | Description                       |\r\n| :-------- | :------- | :-------------------------------- |\r\n| `type`      | `string` | **Required**. Category of joke |\r\n| `number`      | `int` | **Required**. Number of jokes to fetch |\r\n\r\n\r\n\r\n\r\n  \r\n## Authors\r\n\r\n- [Eklavya Chandra](https://www.github.com/eklavyadev)\r\n\r\n  \r\n## Contributing\r\n\r\nContributions are always welcome!\r\n\r\n### Implement jokes.json with this structure\r\n```\r\n},\r\n{\r\n  \"id\": last joke id + 1,\r\n  \"type\": \"Your category here\",\r\n  \"setup\": \"Your joke here\",\r\n  \"punchline\": \"Your punchline here\"\r\n}\r\n```\r\n\r\nPlease adhere to this project's `code of conduct`.\r\n\r\n  \r\n## Run Locally\r\n\r\nClone the project\r\n\r\n```bash\r\n  git clone https://github.com/eklavyadev/karljoke.git\r\n```\r\n\r\nGo to the project directory\r\n\r\n```bash\r\n  cd karljoke\r\n```\r\n\r\nInstall dependencies\r\n\r\n```bash\r\n  npm install\r\n```\r\n\r\nStart the server\r\n\r\n```bash\r\n  npm run start\r\n```\r\n\r\n  \r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feklavyadev%2Fkarljoke","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feklavyadev%2Fkarljoke","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feklavyadev%2Fkarljoke/lists"}