Proxy Webhook Config - sgml/signature GitHub Wiki

Webhooks

WebHooks are HTTP POSTs bound to a URL which will fire a callback to respond to requests sent to it to facilitate server-sent events ala an XML push parser. For example:

Event Subscription via URL => Timestamp Change Event => HTTP POST callback => Synchronization

Proxy Use Cases

WebSub

Publish the feed to superfeedr

The first time you fetch the feed, look for <link> element with rel=hub in it:

<feed xmlns="http://www.w3.org/2005/Atom">
  <title>Superfeedr Blog : Real-time cloudy thoughts from a super-hero</title>
  <link href="https://superfeedr-blog-feed.herokuapp.com/" rel="self" type="application/atom+xml"/>
  <link href="http://blog.superfeedr.com/" rel="alternate" type="text/html"/>
  <link rel="hub" href="http://pubsubhubbub.superfeedr.com/" />
  <updated>2015-02-03T13:08:02+01:00</updated>
  <id>http://blog.superfeedr.com/</id>
...
</feed>

The most important line is:

<link rel="hub" href="http://pubsubhubbub.superfeedr.com/" />

It tells us that this feed is available in real-time at this community hub.

The second most important line is:

<link href="https://superfeedr-blog-feed.herokuapp.com/" rel="self" type="application/atom+xml"/>

It tells us the canonical URL for this feed. It's the actual feed URL that we should use for subscriptions. Most of the time it will be this URL that you might have fetched, but sometimes, it may differ and when that happens, you need to use the self URL.

Subscription

The subscription request is a POST HTTP request. You can issue it using a command line tool like curl or any other type of HTTP library and client. The subscription request is sent to the hub URL (see discovery above).

netcat bash callbacks

References

  1. https://blog.superfeedr.com/howto-pubsubhubbub/
  2. https://codex.wordpress.org/Update_Services
  3. https://zapier.com/apps/rss/integrations/webhook/1746/send-a-webhook-when-an-rss-feed-is-updated
  4. https://api.qualtrics.com/guides/docs/Guides/Actions%20and%20Webhooks/webhooks.md
  5. https://webrender.net/2017/11/23/automate-github-pages-ifttt-glitch.html
  6. https://github.com/adlnet/ADL_LRS/wiki/Webhooks
  7. https://www.codemag.com/Article/1705031/Office-365-Connectors-and-WebHooks-Part-1
  8. https://nordicapis.com/webhooks-vs-websub-which-one-is-better-to-stream-your-events-in-real-time/
  9. https://www.programmableweb.com/news/what-are-webhooks-and-how-do-they-enable-real-time-web/2012/01/30
  10. https://www.programmableweb.com/news/what-pubsubhubbub-push-styled-api-and-how-does-it-work/analysis/2017/04/03
  11. https://stackoverflow.com/questions/36825042/consuming-rss-feed-with-aws-lambda-and-api-gateway
  12. https://developers.google.com/youtube/v3/guides/push_notifications
  13. https://github.com/pubsubhubbub/PubSubHubbub/wiki/RSS-Feeds
  14. https://4sysops.com/archives/sending-a-webhook-via-powershell/
  15. https://dzone.com/articles/setting-up-automation-for-webhooks-testing
  16. https://auth0.com/blog/introduction-to-progressive-web-apps-push-notifications-part-3/
  17. https://chrome.google.com/webstore/detail/send-to-webhook/hoglpfllfgiennflpdodjpaaecpfodpe?hl=en

Proxies

Nuxt

Gatsby

Webhooks

Websub

JSONFeed

Powershell

⚠️ **GitHub.com Fallback** ⚠️