{"id":18542273,"url":"https://github.com/tariqjamel/ktor-rest-api","last_synced_at":"2025-11-01T06:30:30.805Z","repository":{"id":256264404,"uuid":"851750092","full_name":"tariqjamel/Ktor-REST-API","owner":"tariqjamel","description":"This project is a REST API built using Kotlin and Ktor that allows users to perform basic CRUD operations on tasks.","archived":false,"fork":false,"pushed_at":"2024-09-09T18:41:44.000Z","size":325,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-26T05:22:48.901Z","etag":null,"topics":["api","crud","kotlin","ktor","rest-api"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","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/tariqjamel.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-09-03T16:38:30.000Z","updated_at":"2024-09-09T18:41:46.000Z","dependencies_parsed_at":"2024-09-09T23:06:29.327Z","dependency_job_id":"d7869499-8b4d-4dd8-8439-f2db56c3472f","html_url":"https://github.com/tariqjamel/Ktor-REST-API","commit_stats":null,"previous_names":["tariqjamel/ktor-rest-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tariqjamel%2FKtor-REST-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tariqjamel%2FKtor-REST-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tariqjamel%2FKtor-REST-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tariqjamel%2FKtor-REST-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tariqjamel","download_url":"https://codeload.github.com/tariqjamel/Ktor-REST-API/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239262353,"owners_count":19609518,"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","crud","kotlin","ktor","rest-api"],"created_at":"2024-11-06T20:07:54.914Z","updated_at":"2025-11-01T06:30:30.763Z","avatar_url":"https://github.com/tariqjamel.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ktor CRUD REST API\n\nThis project is a REST API built using Kotlin and Ktor that allows users to perform basic CRUD (Create, Read, Update, Delete) operations on tasks. The API enables you to add, remove, and view tasks easily. The project is designed with simplicity and efficiency in mind, using Kotlin's concise syntax and Ktor's powerful features.\n\n## Features\n\n- **Add Task:** Create a new task with a title, description, and priority.\n- **Read Tasks:** View the list of all tasks.\n- **Update Task:** Modify an existing task's details.\n- **Delete Task:** Remove a task from the list.\n\n## Getting Started\n\n### Prerequisites\n\n- [Kotlin](https://kotlinlang.org/) installed\n- [IntelliJ IDEA](https://www.jetbrains.com/idea/) or [Android Studio](https://developer.android.com/studio)\n\n### Installation\n\n1. **Clone the Repository**\n2. **Open the Project**\n\n- Open the cloned project in IntelliJ IDEA or Android Studio.\n\n3. **Run the Application**\n\n- Run the project using the main class configured in your IDE.\n\n## API Endpoints\n\n### 1. Get All Tasks\n\n- **URL:** `/tasks`\n- **Method:** `GET`\n- **Description:** Retrieves a list of all tasks.\n\n\u003cimg  src=\"postman_get.png\" width=\"80%\" height=\"50%\"\u003e\n\n### 2. Add a Task\n\n- **URL:** `/tasks`\n- **Method:** `POST`\n- **Body:**\n\n  ```json\n  {\n    \"title\": \"Task Title\",\n    \"description\": \"Task Description\",\n    \"priority\": \"Low | Medium | High\"\n  }\n\u003cimg  src=\"postman_post.png\" width=\"80%\" height=\"50%\"\u003e\n\n### 3. Delete a Task\n\n- **URL:** `/tasks/{id}`\n- **Method:** `DELETE`\n- **Description:** Deletes a task by ID.\n\u003cimg  src=\"postman_delete.png\" width=\"80%\" height=\"50%\"\u003e\n\n## Testing the API\n\nYou can test the API using tools like Postman or local browser. Each endpoint allows for testing CRUD operations with appropriate request types and payloads.\n\n## Step-by-Step Guidance\n\nFor detailed step-by-step guidance on how to create a REST API using Ktor, you can check out my [Medium article](https://medium.com/@tariqjamel/creating-your-first-rest-api-with-ktor-a-step-by-step-tutorial-b4f6127e4d69). This article will guide you through the process, from setting up your environment to implementing CRUD operations.\n\n## Contributing\n\nContributions are welcome! If you have any suggestions, bug fixes, or feature implementations, please submit a pull request.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftariqjamel%2Fktor-rest-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftariqjamel%2Fktor-rest-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftariqjamel%2Fktor-rest-api/lists"}