{"id":22511018,"url":"https://github.com/salma-4/quiz-api","last_synced_at":"2026-04-19T19:32:52.300Z","repository":{"id":266156414,"uuid":"883962676","full_name":"salma-4/Quiz-API","owner":"salma-4","description":"A RESTful API for creating, managing, and taking quizzes. The API supports user authentication, quiz categorization, and various administrative functionalities.","archived":false,"fork":false,"pushed_at":"2024-12-11T22:53:03.000Z","size":67,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-02T02:28:17.145Z","etag":null,"topics":["assertj","dto-pattern","java","junit","logging","maven","mockito","mysql-database","spring-boot","spring-data-jpa","spring-security-jwt","swagger-ui","unit-testing"],"latest_commit_sha":null,"homepage":"","language":"Java","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/salma-4.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-05T22:16:11.000Z","updated_at":"2024-12-11T22:53:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"3ba5f73b-a9ad-4a5d-88de-0758bc5ff099","html_url":"https://github.com/salma-4/Quiz-API","commit_stats":null,"previous_names":["salma-4/quiz-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salma-4%2FQuiz-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salma-4%2FQuiz-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salma-4%2FQuiz-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salma-4%2FQuiz-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/salma-4","download_url":"https://codeload.github.com/salma-4/Quiz-API/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245949514,"owners_count":20698915,"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":["assertj","dto-pattern","java","junit","logging","maven","mockito","mysql-database","spring-boot","spring-data-jpa","spring-security-jwt","swagger-ui","unit-testing"],"created_at":"2024-12-07T02:07:51.546Z","updated_at":"2026-04-19T19:32:52.252Z","avatar_url":"https://github.com/salma-4.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **Quiz-API**\n\nA RESTful API for creating, managing, and taking quizzes. \nThe API supports user authentication, quiz categorization, and various administrative functionalities.\n\n---\n## **Requirements**\n- Java Development Kit (JDK) 17 or above\n- MySQL Database [Customize yours](https://github.com/salma-4/Quiz-API/blob/master/src/main/resources/application.yml)\n---\n\n## **Features**\n\n- User registration and authentication using JWT.\n- CRUD operations for quizzes.\n- Quiz categorization and search **TODO**.\n- User and admin-specific operations **TODO**.\n\n---\n\n## **Endpoints**\n\n### **1. User Authentication (Auth)**\n\nHandles user registration, login, and other authentication-related actions.\n\n| No. | Feature | Body | Header | Description | Endpoint |\n|----:|---------------------|-----------------------------|-------------|----------------------------------------|------------------------------------------|\n| 1. | Login | username(unique) , password | | generate new token for user | `POST quizApp/v1/auth/login ` |\n| 2. | Register | Data of user | | Add new user create token | `POST quizApp/v1/auth/newUser ` |\n| 3. | Logout | | Token | Logging out | `POST quizApp/v1/auth/logout ` |\n| 4. | Forget password | | param/email | Send OTP to email | `POST /quizApp/v1/auth/user?email=` |\n| 5. | Reset password | OTP ,new password | | Check OTP validity and update password | `POST quizApp/v1/auth/user/newPassword ` |\n| 6. | Regenerate password | | param/email | regenerate OTP and send it | `POST quizApp/v1/auth/user/otp?email= ` |\n\n\n### **2.Quiz Management**\nOperations related to quizzes.\n\n| No. | Feature | Body | Header | Description | Endpoint |\n|----:|----------------|--------------------------------|--------|--------------------------------------------|--------------------------------------|\n| 1. | Create quiz | Quiz data (category ,question) | Token | Create new Quiz to specified category | `POST quizApp/v1/quiz ` |\n| 2. | All categories | | Token | Show all categories of quizzes exist | `GET quizApp/v1/quiz/allCategories ` |\n| 3. | Quiz by cat. | | Token | Show list of quizzes to specified category | `GET quizApp/v1/quiz/{category} ` |\n| 4. | Delete quiz | | Token | Delete quiz by its id | `GET quizApp/v1/quiz/{quizId} ` |\n| 5. | Get quiz by id | | Token | | ` ` |\n| 6. | Assign quiz | | Token | | ` ` |\n| 7. | |\n| 8. | |\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalma-4%2Fquiz-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsalma-4%2Fquiz-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalma-4%2Fquiz-api/lists"}