How to validate GitHub webhook signatures with go-playground/webhooks?

The library handles signature validation internally; you provide the secret during initialization, and it automatically verifies payloads for supported platforms. Check the godoc for platform-specific options like github.Options.Secret.

go-playground/webhooks vs other Go webhook libraries like gopkg.in/go-playground/webhooks.v5

go-playground/webhooks v6 is the updated version with breaking changes and improved support, while older versions may lack features. It focuses on type safety and multi-platform parsing, whereas alternatives might offer different trade-offs like lighter weight or broader format support.

How to handle multiple event types from GitLab webhooks in Go?

Use the hook.Parse method with a list of event types, as shown in the example, then use a type switch to process different payloads. This allows efficient handling without parsing unwanted events.

Does go-playground/webhooks support Docker Hub webhook events?

Yes, it includes support for Docker Hub webhooks, enabling parsing of events like image pushes into structured Go types. Refer to the docker package in the godoc for specific details and usage.

How to add a new webhook service to go-playground/webhooks?

Contributions are welcome; you need to create a new package with structs matching the service's JSON schema and implement parsing logic. Follow existing patterns in the repository and submit a pull request, as mentioned in the README.

What's the performance impact of using go-playground/webhooks?

It's designed for efficiency with event filtering, but parsing entire payloads can be memory-intensive for large webhooks. For high-volume systems, benchmark and optimize by limiting parsed events to necessary types only.

Open-Awesome

Categories Alternatives Stacks Self-Hosted Explore

Open-Awesome

Terms Privacy About GitHub RSS

webhooks — Go Webhook Event Parser | Open Awesome

webhooks

webhooks

MITGov6.4.0

A Go library for receiving and parsing webhook events from GitHub, Bitbucket, GitLab, Docker Hub, Gogs, and Azure DevOps.

GitHub

What is webhooks?

Webhooks is a Go library designed to receive and parse webhook events from multiple development platforms including GitHub, Bitbucket, GitLab, Docker Hub, Gogs, and Azure DevOps. It solves the problem of manually handling webhook payloads by providing structured Go types that match the JSON schema from each service.

Target Audience

Go developers building applications that need to integrate with webhooks from popular development and deployment platforms.

Value Proposition

Developers choose Webhooks because it provides complete payload parsing with type safety, supports multiple platforms from a single library, and eliminates the boilerplate code typically required for webhook integration.

Overview

:fishing_pole_and_fish: Webhook receiver for GitHub, Bitbucket, GitLab, Gogs

Use Cases

Best For

Building CI/CD pipelines that react to repository events
Creating automation tools that respond to Git platform webhooks

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

1.0k stars241 forks0 contributors

Developing deployment systems triggered by Docker Hub pushes

Implementing notification systems for code review events

Creating integrations with multiple Git hosting services

Building internal tools that process webhook data from Azure DevOps

Not Ideal For

Projects integrating with webhook providers that use XML or non-JSON payload formats
Teams needing support for less common or custom webhook services not in the supported list
Applications where minimal library size is critical, as this might include more dependencies than a custom solution

Pros & Cons

Pros

Complete Payload Parsing

Parses the entire webhook payload into Go structs, ensuring all data is accessible without manual JSON handling, as highlighted in the README's features.

Type-Safe Schema

Fields directly correspond to the JSON posted by each service, reducing integration complexity and errors, as stated in the README's schema alignment.

Multi-Platform Integration

Supports six popular development platforms from a single library, simplifying codebases that interact with multiple services, per the README's list.

Event Filtering Capability

Allows parsing only specific event types, improving efficiency and security by ignoring irrelevant webhooks, as shown in the usage example.

Cons

JSON-Only Support

The library currently only accepts JSON payloads, as noted in the README, which excludes services using XML or other formats.

Limited Provider List

With support for only six platforms, developers must handle unsupported webhooks manually or seek alternatives, limiting out-of-the-box compatibility.

Documentation Depth

Primary documentation is via godoc, which may lack comprehensive tutorials or examples for complex use cases beyond basic setup.

Frequently Asked Questions

Quick Stats

Stars1,029

Forks241

Contributors0

Open Issues19

Last commit1 year ago

CreatedSince 2015

Built With

Included in

Auto-fetched 10 hours ago

Home

github

Go library for accessing the GitHub v3 API

OpenAI ChatGPT, GPT-5, GPT-Image-1, Whisper API clients for Go

Stars10,689

Forks1,699

Last commit7 months ago

Discordgo

(Golang) Go bindings for Discord

Stars5,930

Forks921

Last commit3 months ago

slack

Slack API in Go

Stars4,944

Forks1,188

Last commit3 days ago