{"id":30621331,"url":"https://github.com/herdiansc/falcon-rest-api","last_synced_at":"2025-08-30T14:28:36.102Z","repository":{"id":146136054,"uuid":"272126056","full_name":"herdiansc/falcon-rest-api","owner":"herdiansc","description":"An example of a REST api using falcon","archived":false,"fork":false,"pushed_at":"2024-04-17T00:03:39.000Z","size":258,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-17T06:31:40.243Z","etag":null,"topics":["falcon","rest-api"],"latest_commit_sha":null,"homepage":null,"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/herdiansc.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}},"created_at":"2020-06-14T03:28:22.000Z","updated_at":"2020-06-14T04:04:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"39cd1f98-0448-4939-834e-433eec98c545","html_url":"https://github.com/herdiansc/falcon-rest-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/herdiansc/falcon-rest-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/herdiansc%2Ffalcon-rest-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/herdiansc%2Ffalcon-rest-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/herdiansc%2Ffalcon-rest-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/herdiansc%2Ffalcon-rest-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/herdiansc","download_url":"https://codeload.github.com/herdiansc/falcon-rest-api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/herdiansc%2Ffalcon-rest-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272860662,"owners_count":25005470,"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","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"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":["falcon","rest-api"],"created_at":"2025-08-30T14:28:01.647Z","updated_at":"2025-08-30T14:28:36.092Z","avatar_url":"https://github.com/herdiansc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Falcon REST API\nThis is an ecample project of a rest api server built with falcon.\n\n## Features\n- Contains 2 resources: users and clothes\n- Contains CRUD for each resource\n- Demontrates simple authentication using JWT\n- [EXPERIMENTAL] Demontrates upload image\n- Acceptance test\n- [TBD] Unit test\n- Docker containerization\n\n## How to Run\nRun this project using docker:\n- `docker-compose up --build` to build the project\n- `docker-compose start` to start the project\n- access `http://localhost:9000/[resource]` where `resource` is either `users|clothes`\n\n## Example request\n- Uses jwt token, here is an example of a valid jwt token: `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhIjoiYiJ9.jiMyrsmD8AoHWeQgmxZ5yq8z0lXS67_QGs52AzC8Ru8`\n- Get users: `curl -XGET -H \"Content-type: application/json;\" -H \"Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhIjoiYiJ9.jiMyrsmD8AoHWeQgmxZ5yq8z0lXS67_QGs52AzC8Ru8\" 'http://localhost:9000/users'`\n- Add clothe: `curl -XPOST -H \"Content-type: application/json\" -H \"Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhIjoiYiJ9.jiMyrsmD8AoHWeQgmxZ5yq8z0lXS67_QGs52AzC8Ru8\" -d '{\"name\":\"herdian\",\"email\":\"herdian@mail.com\",\"size\":\"S\"}' 'http://localhost:9000/clothes'`\n\n# Running Tests\n- Go to project root directory\n- Run `py.test app/tests/ -vv`\n- Screenshot of the test result:\n![test result](https://raw.githubusercontent.com/herdiansc/falcon-rest-api/master/screenshots/test_result.png \"test result\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fherdiansc%2Ffalcon-rest-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fherdiansc%2Ffalcon-rest-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fherdiansc%2Ffalcon-rest-api/lists"}