{"id":24650615,"url":"https://github.com/ujitkumar1/hackathonapi","last_synced_at":"2026-05-10T19:54:47.694Z","repository":{"id":182343332,"uuid":"621352966","full_name":"ujitkumar1/HackathonAPI","owner":"ujitkumar1","description":"HackathonAPI: A Python app for managing hackathons and submissions","archived":false,"fork":false,"pushed_at":"2023-04-04T05:24:42.000Z","size":445,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-25T18:16:10.755Z","etag":null,"topics":["flask-restful","hackathon-project","python","restful-api"],"latest_commit_sha":null,"homepage":"https://github.com/ujitkumar1/HackathonAPI","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ujitkumar1.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-03-30T13:47:39.000Z","updated_at":"2023-04-03T18:59:13.000Z","dependencies_parsed_at":"2023-07-19T17:02:40.147Z","dependency_job_id":null,"html_url":"https://github.com/ujitkumar1/HackathonAPI","commit_stats":null,"previous_names":["ujitkumar1/hackathonapi"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ujitkumar1%2FHackathonAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ujitkumar1%2FHackathonAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ujitkumar1%2FHackathonAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ujitkumar1%2FHackathonAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ujitkumar1","download_url":"https://codeload.github.com/ujitkumar1/HackathonAPI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244686318,"owners_count":20493423,"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":["flask-restful","hackathon-project","python","restful-api"],"created_at":"2025-01-25T18:16:12.437Z","updated_at":"2026-05-10T19:54:42.664Z","avatar_url":"https://github.com/ujitkumar1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## HackathonAPI: A Python app for managing hackathons and submissions\n\n### Description:\n\nHackathonAPI is a RESTful API that provides endpoints for managing hackathons and submissions. With HackathonAPI, you can create and manage hackathons, track submissions, and award prizes to winners. The API is designed to be easy to use and flexible, allowing you to customize the hackathon rules and submission types to fit your needs. Whether you're hosting a small internal hackathon or a large public competition, HackathonAPI can help streamline the process and make it easier to manage.\n\n### Prerequisites:\n\n1. Python Programming language\n2. MySql\n3. flask\n4. flask_restful\n5. json\n\n### Installation:\n\nTo install the required packages and libraries, run the following command in your current working directory:\n\ncommand\n\n```pip install -r requirements.txt```\n\nThis command will install all the necessary dependencies listed in the requirements.txt file, allowing you to run the\nproject without any issues.\n\n### Usage:\n\nTo run the application, execute the following command in your current working directory:\n\nCommand\n\n```python main.py```\n\nThis will start the application, and you should be able to use it. (or) Directly run the main.py file\n\n#### Endpoint Working:\n\n1. **User Registration**(```http://127.0.0.1:5000/register```)\n\n    - Endpoint for creating a new User.\n   \n      ![img.png](documentaionImage/img.png)\n    - \n    - Example:\n\n      Input:\n      ```\n      Json_data = {\n       \"username\":\"ujit1\",\n       \"password\":\"123\"\n      }\n      ```\n\n      Output:\"message\": \"User created successfully.\"\n\n2. **Hackathon Registration**(```http://localhost:5000/create-hackathons```)\n\n    - Endpoint for creating a New Hackathon(POST)\n\n    - Example:\n      \n      Authorization:\n   \n     ![img_1.png](documentaionImage/img_1.png)\n      \n      Working:\n   \n    - ![img_2.png](documentaionImage/img_2.png)\n     \n3. **Retrieving Hackathons**(```http://localhost:5000/create-hackathons```)\n\n    - Endpoint for Retrieving Hackathon(GET)\n\n    - Example:\n      \n      Authorization:\n   \n     ![img_1.png](documentaionImage/img_1.png)\n      \n      Working:\n   \n    - ![img_3.png](documentaionImage/img_3.png)\n\n4. **User Registering for Hackathons**(```http://localhost:5000/register-hackathon```)\n\n    - Endpoint for  User Registering for Hackathons\n\n    - Example:\n      \n      Authorization:\n   \n     ![img_1.png](documentaionImage/img_1.png)\n      \n      Working:\n   \n    - ![img_4.png](documentaionImage/img_4.png)\n\n4. **User Submission for Hackathons**(```http://localhost:5000/submit-hackathon```)\n\n    - Endpoint for User Submission for Hackathons\n\n    - Example:\n      \n      Authorization:\n   \n     ![img_1.png](documentaionImage/img_1.png)\n      \n      Working:\n\n     ![img_5.png](documentaionImage/img_5.png)\n\n5. **User Submissions for all Hackathons**(```http://localhost:5000/my-hackathons/\u003cint:user_id\u003e```)\n\n    - Endpoint for retrieving the all Submission of a User\n\n    - Example:\n      \n      Authorization:\n   \n     ![img_1.png](documentaionImage/img_1.png)\n      \n      Working:\n\n      ![img_6.png](documentaionImage/img_6.png)\n\n5. **User Submissions for particular Hackathons**(```http://localhost:5000/my-submissions/\u003cint:user_id\u003e/\u003cint:hackathon_id\u003e```)\n\n    - Endpoint for retrieving the particular Submission of a User\n\n    - Example:\n      \n      Authorization:\n   \n     ![img_1.png](documentaionImage/img_1.png)\n      \n      Working:\n\n      ![img_7.png](documentaionImage/img_7.png)\n     \n\n#### In addition to the code and documentation, I have included a Postman request file named \"CheckHacathon.postman_collection.json\" in the \"postmanJson\" directory. This file contains a collection of requests that were made using the Postman application, providing a convenient way to test the functionality of the API.\n\n\n### Contact:\n\nName : Ujit Kumar\n\nEmail : ujitkumar1@gmail.com \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fujitkumar1%2Fhackathonapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fujitkumar1%2Fhackathonapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fujitkumar1%2Fhackathonapi/lists"}