{"id":13551220,"url":"https://github.com/emreler/finch","last_synced_at":"2025-04-03T01:31:41.324Z","repository":{"id":84983217,"uuid":"79493743","full_name":"emreler/finch","owner":"emreler","description":null,"archived":false,"fork":false,"pushed_at":"2020-12-19T21:05:50.000Z","size":155,"stargazers_count":183,"open_issues_count":0,"forks_count":12,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-12-09T02:02:37.582Z","etag":null,"topics":["finch","go","golang","scheduler"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emreler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-01-19T20:49:59.000Z","updated_at":"2024-05-14T08:03:09.000Z","dependencies_parsed_at":"2023-03-13T03:55:42.318Z","dependency_job_id":null,"html_url":"https://github.com/emreler/finch","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emreler%2Ffinch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emreler%2Ffinch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emreler%2Ffinch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emreler%2Ffinch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emreler","download_url":"https://codeload.github.com/emreler/finch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246922092,"owners_count":20855341,"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":["finch","go","golang","scheduler"],"created_at":"2024-08-01T12:01:44.342Z","updated_at":"2025-04-03T01:31:40.987Z","avatar_url":"https://github.com/emreler.png","language":"Go","funding_links":[],"categories":["Go","golang"],"sub_categories":[],"readme":"# Finch\n\n[![Build Status](https://travis-ci.org/emreler/finch.svg?branch=master)](https://travis-ci.org/emreler/finch)\n\nThis is the source code repository for the Finch project.\n\n## What is it\nFinch is a simple service that handles scheduled tasks for your apps, services. You can use the developer friendly API to create your tasks to be completed in a future date, periodically repeated. In plain English, you can create tasks like \"Send a request to this URL with this JSON body every morning\". That could save you a ton of work when just developing a to-do app.\n\nFor now it can send HTTP requests with GET, POST methods and request body of your choice, which can be plain text, form or JSON.\n\n## How to use it\nYou can use the Swagger page [here](https://github.com/emreler/finch/blob/master/swagger.yaml) to check the endpoints, required fields, expected responses as well as making the actual API calls.\n\n### Getting Access Token\nTo use the API you will need an access token. You can create yourself one using the `POST /users` endpoint. As a response you will receive the token ([JWT](https://en.wikipedia.org/wiki/JSON_Web_Token)).\n\n### Authenticating API calls\nAs you can see in the Swagger page, all endpoints are expecting `Authorization` header. Value of the `Authorization` header must be in the format `Bearer ACCESS_TOKEN`, where `ACCESS_TOKEN` is the one obtained with the step above.\n\n## Running it Yourself\n### Using Docker and Docker Compose\nYou need to have `docker` and `docker-compose` installed on your system. After that it is as simple as running `docker-compose up`. Finch will be listening on `127.0.0.1:8081`, so you can access the API using URLs like `http://localhost:8081/v1/users`.\n\nFinch is using MongoDB and Redis for storing its data, and those services are configured to use volumes in `docker-compose.yml`. So your data will remain in `mongo-data` and `redis-data` folders even if you remove the containers.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femreler%2Ffinch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femreler%2Ffinch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femreler%2Ffinch/lists"}