https://github.com/frain-dev/convoy

The Cloud Native Webhooks Gateway
https://github.com/frain-dev/convoy

angular api-gateway automation cli cloud convoy developer-tools devtools gateway gateways golang incoming-webhooks infrastructure outgoing-webhooks webhook-gateway webhook-service webhooks webhooks-server

Last synced: 21 days ago
JSON representation

The Cloud Native Webhooks Gateway

• Host: GitHub
• URL: https://github.com/frain-dev/convoy
• Owner: frain-dev
• License: other
• Created: 2021-04-17T17:37:17.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-09T09:36:26.000Z (27 days ago)
• Last Synced: 2024-10-09T11:35:46.552Z (27 days ago)
• Topics: angular, api-gateway, automation, cli, cloud, convoy, developer-tools, devtools, gateway, gateways, golang, incoming-webhooks, infrastructure, outgoing-webhooks, webhook-gateway, webhook-service, webhooks, webhooks-server
• Language: Go
• Homepage: https://getconvoy.io
• Size: 76.1 MB
• Stars: 2,455
• Watchers: 24
• Forks: 138
• Open Issues: 75
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-github-repos - frain-dev/convoy - The Cloud Native Webhooks Gateway (Go)

README

        
![convoy image](./convoy-logo.svg)

=========

[![golangci-lint](https://github.com/frain-dev/convoy/actions/workflows/linter.yml/badge.svg)](https://github.com/frain-dev/convoy/actions/workflows/linter.yml)

[![Build and run all tests](https://github.com/frain-dev/convoy/actions/workflows/go.yml/badge.svg)](https://github.com/frain-dev/convoy/actions/workflows/go.yml)

- Website: https://getconvoy.io

- Forum: [Convoy Community](https://community.getconvoy.io)

- Documentation: [docs.getconvoy.io](https://docs.getconvoy.io)

- Deploy: [Install Convoy](https://docs.getconvoy.io/deployment/install-convoy/docker)

- Slack: [Join the Community](https://join.slack.com/t/convoy-community/shared_invite/zt-xiuuoj0m-yPp~ylfYMCV9s038QL0IUQ)

[Convoy](https://getconvoy.io) is an open source high-performance webhooks gateway used to securely ingest, persist, debug, deliver and manage millions of events reliably with rich features such as retries, rate limiting, static ips, circuit breaking, rolling secrets and more. 

Convoy provides several key features:

- **Webhooks Gateway:** As a webhooks gateway, Convoy lives at the edge of your network to stream webhooks from your microservices, and send them out to your users as well as receive webhooks from your providers and route them to the required services. With this your internal systems are never exposed to the public internet.

- **Scalability:** Convoy acts as a dedicated message queue for webhooks, and was designed to be horizontally scalable. It includes several components like the `api server`, `workers`, `scheduler`, and `socket server` which can be scaled independently to fit the need.

- **Security:** Convoy ships with several security features for webhooks, such as payload signing to ensure message integrity, bearer token authentication for authenticated webhook endpoints, and static ips for network environments with strict firewall rules.

- **Fan Out:** Convoy is able to route an event to multiple endpoints based on the event type or payload structure.

- **Rate Limiting:** While Convoy is able to ingest events at a massive rate, it throttles the delivery of these events to the endpoints at a configurable rate per endpoint. 

- **Retries & Batch Retries:** Convoy supports two retry algorithms; constant time and exponential backoff with jitter. Where automatic retries are not sufficient, convoy provides batch retries for endpoints are consecutively failed to process retried events.

- **Customer-Facing Dashboards:** Convoy allows you to generate customer facing webhooks dashboard to embed into your applications using an iframe. On this dashboard, users can debug webhooks, retry events, add endpoints, and configure each endpoint's subscription.

- **Endpoint Failure Notifications:** When endpoints consecutively fails to process events, convoy disables the endpoint and sends out a notification. Two types of notifications are supported: Email and Slack Notifications.

## Installation

- [Docker](https://docs.getconvoy.io/deployment/install-convoy/docker)

- [Kubernetes with Helm](https://docs.getconvoy.io/deployment/install-convoy/kubernetes)

## Contributing

Thank you for your interest in contributing! Please refer to [CONTRIBUTING.md](https://github.com/frain-dev/convoy/blob/main/CONTRIBUTING.md) for guidance. For contributions to the Convoy dashboard, please refer to the [web/ui](https://github.com/frain-dev/convoy/tree/main/web/ui) directory.

## License

[Elastic License v2.0](https://github.com/frain-dev/convoy/blob/main/LICENSE)