{"id":39526255,"url":"https://github.com/beka-birhanu/financial-tracker--backend","last_synced_at":"2026-01-18T06:24:33.813Z","repository":{"id":246816520,"uuid":"822250377","full_name":"beka-birhanu/financial-tracker--backend","owner":"beka-birhanu","description":"simple single CRUD project I used to learn ASP.NET 8","archived":false,"fork":false,"pushed_at":"2024-07-12T20:09:05.000Z","size":98,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-07-13T17:52:19.468Z","etag":null,"topics":["aspnet-core","dotnetcli","restful-api","sqlite"],"latest_commit_sha":null,"homepage":"","language":"C#","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/beka-birhanu.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-06-30T17:50:08.000Z","updated_at":"2024-07-12T20:09:08.000Z","dependencies_parsed_at":"2024-07-11T17:26:11.743Z","dependency_job_id":null,"html_url":"https://github.com/beka-birhanu/financial-tracker--backend","commit_stats":null,"previous_names":["beka-birhanu/financial-tracker-backend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/beka-birhanu/financial-tracker--backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beka-birhanu%2Ffinancial-tracker--backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beka-birhanu%2Ffinancial-tracker--backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beka-birhanu%2Ffinancial-tracker--backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beka-birhanu%2Ffinancial-tracker--backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beka-birhanu","download_url":"https://codeload.github.com/beka-birhanu/financial-tracker--backend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beka-birhanu%2Ffinancial-tracker--backend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28531995,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["aspnet-core","dotnetcli","restful-api","sqlite"],"created_at":"2026-01-18T06:24:33.245Z","updated_at":"2026-01-18T06:24:33.801Z","avatar_url":"https://github.com/beka-birhanu.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Financial Tracker\n\nThis is a back-end for a Financial-tracker, an app I made to learn React and to learn the basics of CRUD RESTful API in C#.\n\n## Technologies\n\n1. ASP.NET 8\n2. SQLite\n3. dotnet CLI\n\n## Usage\n\nSimply clone the repository and run the command:\n\n```bash\ndotnet run --project Finance\n```\n\n## API Definition (Expense)\n\n### Create Expense\n\n#### Request\n\n```\nPOST /expenses\n```\n\n```json\n{\n  \"title\": \"Groceries\",\n  \"amount\": 279.7,\n  \"date\": \"2024-06-08T08:00:00\"\n}\n```\n\n#### Response\n\n```\n201 Created\n```\n\n```\nLocation: {{host}}/expenses/{{id}}\n```\n\n```json\n{\n  \"id\": \"00000000-0000-0000-0000-000000000000\",\n  \"title\": \"Groceries\",\n  \"amount\": 279.7,\n  \"date\": \"2024-06-08T08:00:00\"\n}\n```\n\n### Get Expenses\n\n#### Get Bulk Request\n\n```\nGET /expenses?pageNumber={yourPart}\u0026pageSize={yourPart}\u0026filterField={yourPart}\u0026filterValue={yourPart}\u0026sortField={yourPart}\u0026sortOrder={yourPart}\n```\n\n#### Response\n\n```\n200 OK\n```\n\n```json\n{\n  \"expenses\": [\n    {\n      \"id\": \"286d7bbf-e6e0-4bfd-b4e0-906a613193db\",\n      \"title\": \"Car Repair\",\n      \"amount\": 350.5,\n      \"date\": \"2024-02-15T08:00:00\"\n    },\n    {\n      \"id\": \"3f91f017-af32-46b3-9c53-47adb1314c9a\",\n      \"title\": \"Groceries\",\n      \"amount\": 75.3,\n      \"date\": \"2024-03-10T08:00:00\"\n    },\n    {\n      \"id\": \"9faf45e0-38c5-4c27-b9d8-f6b04b719060\",\n      \"title\": \"Electric Bill\",\n      \"amount\": 120.75,\n      \"date\": \"2024-04-05T08:00:00\"\n    },\n    {\n      \"id\": \"805795d0-f73d-4334-94af-ce4fab83e142\",\n      \"title\": \"Dinner Out\",\n      \"amount\": 60.2,\n      \"date\": \"2024-04-18T08:00:00\"\n    },\n    {\n      \"id\": \"537126c9-f485-4674-900e-c77ae349c25f\",\n      \"title\": \"Movie Tickets\",\n      \"amount\": 45.0,\n      \"date\": \"2024-05-01T08:00:00\"\n    }\n  ],\n  \"totalCount\": 5,\n  \"pageNumber\": 1,\n  \"pageSize\": 10\n}\n```\n\n#### Get One Request\n\n```\nGET /expenses/{{id}}\n```\n\n#### Response\n\n```\n200 OK\n```\n\n```json\n{\n  \"id\": \"00000000-0000-0000-0000-000000000000\",\n  \"title\": \"Groceries\",\n  \"amount\": 279.7,\n  \"date\": \"2024-06-08T08:00:00\"\n}\n```\n\n### Update Expense\n\n#### Request\n\n```\nPUT /expenses/{{id}}\n```\n\n```json\n{\n  \"id\": \"00000000-0000-0000-0000-000000000000\",\n  \"title\": \"Groceries\",\n  \"amount\": 279.7,\n  \"date\": \"2024-06-08T08:00:00\"\n}\n```\n\n#### Response\n\n```\n204 No Content\n```\n\nor\n\n```\n201 Created\n```\n\n```\nLocation: {{host}}/expenses/{{id}}\n```\n\n### Delete Expense\n\n#### Request\n\n```\nDELETE /expenses/{{id}}\n```\n\n#### Response\n\n```\n204 No Content\n```\n\n## API Definition (User)\n\n### Create User\n\n#### Request\n\n```\nPost /users\n```\n\n```json\n{\n  \"firstName\": \"Beka\",\n  \"lastName\": \"Birhanu\",\n  \"email\": \"romareo@gmail.com\",\n  \"password\": \"************\"\n}\n```\n\n#### Response\n\n```\n201 Created\n```\n\n**Headers**\n\n```\nSet-Cookie: token\n```\n\n```json\n{\n  \"id\": \"00000000-0000-0000-0000-000000000000\",\n  \"firstName\": \"Beka\",\n  \"lastName\": \"Birhanu\",\n  \"email\": \"romareo@gmail.com\"\n}\n```\n\n## API Definition (Authentication)\n\n### Sign in\n\n#### Request\n\n```\nPost /auth/signIn\n```\n\n```json\n{\n  \"email\": \"romareo@gmail.com\",\n  \"password\": \"************\"\n}\n```\n\n#### Response\n\n```\n200 Ok\n```\n\n**Headers**\n\n```\nSet-Cookie: token\n```\n\n```json\n{\n  \"id\": \"00000000-0000-0000-0000-000000000000\",\n  \"firstName\": \"Beka\",\n  \"lastName\": \"Birhanu\",\n  \"email\": \"romareo@gmail.com\"\n}\n```\n\n### Sign out\n\n#### Request\n\n```\nPost /auth/signOut\n```\n\n#### Response\n\n```\n204 No Content\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeka-birhanu%2Ffinancial-tracker--backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeka-birhanu%2Ffinancial-tracker--backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeka-birhanu%2Ffinancial-tracker--backend/lists"}