GitPlanet

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details
All Projects → kewang → webhooks-tw

kewang / webhooks-tw

Licence: other
http://www.webhooks.org/ 的維基非官方正體中文翻譯

Labels

webhooksopenapi

Projects that are alternatives of or similar to webhooks-tw

asymmetric
Ridiculously fast and easy module-to-API transformations. Learn in minutes, implement in seconds. Batteries included.
Stars: ✭ 35 (+169.23%)
Mutual labels:  openapi
commercetools-api-reference
commercetools API reference documentation
Stars: ✭ 41 (+215.38%)
Mutual labels:  openapi
webhook-server
The express server that we use to handle incoming webhooks from various services.
Stars: ✭ 25 (+92.31%)
Mutual labels:  webhooks
gohooks
GoHooks make it easy to send and consume secured web-hooks from a Go application
Stars: ✭ 16 (+23.08%)
Mutual labels:  webhooks
iris
Watch on Kubernetes events, filter and send them as standard wehbook to any system
Stars: ✭ 57 (+338.46%)
Mutual labels:  webhooks
idoc
📒📚Generate beautiful interactive documentation and Open-API 3.0 spec file from your existing Laravel app.
Stars: ✭ 95 (+630.77%)
Mutual labels:  openapi
lasso
Real-time UI for webhooks
Stars: ✭ 27 (+107.69%)
Mutual labels:  webhooks
api
🚀 Automatic SDK generation from an OpenAPI definition
Stars: ✭ 127 (+876.92%)
Mutual labels:  openapi
openapi
OpenAPI (fka Swagger) spec renderer for Sphinx.
Stars: ✭ 78 (+500%)
Mutual labels:  openapi
openapi-lint-vscode
OpenAPI 2.0/3.0.x intellisense, validator, linter, converter and resolver extension for Visual Studio Code
Stars: ✭ 47 (+261.54%)
Mutual labels:  openapi
les
Go directly from an event storming to a working API: Event Markdown / Markup validation & NodeJS CQRS/ES application builder.
Stars: ✭ 48 (+269.23%)
Mutual labels:  openapi
PostgREST-writeAPI
Translate your OpenAPI specification into a NGinx config-file to implement your PostgREST system
Stars: ✭ 31 (+138.46%)
Mutual labels:  openapi
CreateAPI
Delightful code generator for OpenAPI specs
Stars: ✭ 176 (+1253.85%)
Mutual labels:  openapi
box-openapi
OpenAPI 3.0 Specification for the Box APIs
Stars: ✭ 71 (+446.15%)
Mutual labels:  openapi
shield
A laravel middleware to protect against unverified webhooks from 3rd party services.
Stars: ✭ 96 (+638.46%)
Mutual labels:  webhooks
light-rest-4j
A RESTful framework built on top of light-4j with both Swagger 2.0 and OpenAPI 3.0 supports
Stars: ✭ 113 (+769.23%)
Mutual labels:  openapi
apiflask
A lightweight Python web API framework.
Stars: ✭ 442 (+3300%)
Mutual labels:  openapi
shipengine-openapi
The official OpenAPI 3.0 definitions for ShipEngine™
Stars: ✭ 13 (+0%)
Mutual labels:  openapi
fhir-fuel.github.io
Place to prepare proposal to FHIR about JSON, JSON-Schema, Swagger/OpenAPI, JSON native databases and other JSON-frendly formats (yaml, edn, avro, protobuf etc) and technologies
Stars: ✭ 20 (+53.85%)
Mutual labels:  openapi
kubeopenapi-jsonschema
layer5.io
Stars: ✭ 14 (+7.69%)
Mutual labels:  openapi
View All Similar Projects ➔

webhooks-tw

什麼是 WebHooks？

WebHooks 的概念很簡單，其實就是 HTTP 版本的 callback：當有事情發生時就送出一個 HTTP POST 的請求；也可以稱為是透過 HTTP POST 請求的事件通知簡易版。

在 Web 應用程式上實作 WebHooks，就是當特定事物產生時發送一個 HTTP POST 的請求，裡面會夾帶一個訊息並送到某個特定的網址。當這個應用程式開放使用者註冊他們自己的網址時，這些使用者就可以擴充、客製及整合這個應用程式到他們自己的擴充服務，甚至是網路上的其他 Web 應用程式。對使用者來說，當 WebHooks 發生時，它真的是一個獲得具有價值資訊的方式，而不像以前要不停地透過輪詢取得絕大部分時間無用的資訊。WebHooks 具有極大的潛力，只有你的想像力才有可能限制你自己！(當然，它還沒辦法幫你洗碗。)

WebHooks 意思就是拿來 做 一些事。為了讓 你 的 Web 應用程式更能程式化，下面分成三個較常見的 WebHooks 型式。

推送服務：即時取得資料

「推送服務」是用 WebHooks 最簡單的理由。就像前面所提的，不必再每隔幾分鐘就輪詢一次確認是否有新資料。只要註冊 WebHooks 之後，有新資料時就會馬上知道。這不需要花太多工夫，也一點都不麻煩，而且你會發現取得資訊的速度比以前每隔幾分鐘用輪詢的方式要快多了。

管線服務：取得資料然後送給其他服務

除了傳遞即時資料之外，WebHooks 也可以用這份資料觸發一些與原本事件無關的動作，這就叫做「管線服務」。比如說可以把 WebHooks 註冊在相簿網站上，然後當你老媽上傳一張新相片到網站上就發電子郵件通知你。或是當你在電商網站新增了一個新商品時，即時透過 Twitter 發一則新訊息推銷出去。

外掛程式：處理資料後將資料返回

這就是把全世界的網路變成一個可程式化的平台。可以讓其他使用者用外掛程式來擴充你的應用程式。Facebook Application Platform 及 Google Wave 就是用這種方式來整合他們自己的服務。作法就是將 Web 應用程式的資料透過 WebHooks 送出去，然後把 response 取回來改變自己的資料。以 Facebook 為例，當你要存取 Facebook 上的某個應用程式時，Facebook 會送出一個 WebHooks 並且跟應用程式說「哈囉，有人要存取你的應用程式囉，我該怎麼做才好？」，應用程式就會請 Facebook 把使用者的資訊顯示在這一頁。而 Google Wave 則是當你在 wave 上面做任何動作時，你所加入的所有機器人協作者都會透過 WebHooks 的方式收到通知，而且機器人可以變更這個 wave 的 response。如果你想要允許其他使用者合法地擴充且增加 Web 應用程式時，用「外掛程式」來處理是一個比較好的方式。

WebHooks 的運作方式為何？

Web 應用程式可以讓使用者自行將特定網址關聯到各種事件，當事件發生時應用程式就會將資料使用 POST 的方式傳送給這些特定網址。而現在許多便宜的 PHP 主機甚至可以使用 AppJet 或 Scriptlets 這類腳本語言，讓 POST 資料變的更簡單。你要如何做這些事情一切都由你自己決定，除此之外你也可以完成下列各種動作：

  • 透過電子郵件或聊天室產生提醒給你
  • 發送資料到另一個應用程式 (即時資料同步)
  • 處理資料而且重新用 API 發送這些資料到另一個應用程式
  • 驗證且保護這些資料，防止被其他應用程式所使用

為什麼我要開始在乎 WebHook？

我們開始察覺網路也可以做整合，大部分的 Web 應用程式到現在都還是閉門造車，自己玩自己的。再加上 API 的盛行，我們看到許多混搭及互相整合的應用程式。但是我們還沒發現可程式化網路的美景：一個可以讓使用者在 Web 應用程式之間傳送資料的網路，就像是 Unix 命令列模式一樣。有些人說 RSS 就是解答，但是他們錯了。RSS 的核心價值沒錯，但是實作方式是錯的。RSS 還是非常有用，但它沒辦法幫我們帶來一個真正的可程式化網路。

我們只需要一個簡便的方式讓使用者能夠很簡單地即時取得他們想要的任何資料。這表示不用輪詢機制、沒有任何內容限制，也不需解析 XML。這表示答案根本就不是 RSS。使用 HTTP 愈來愈容易。PHP 是一個非常受歡迎而且容易取得的程式開發環境，所以非常適合用來撰寫 hooklets，在 PHP 上面從 POST 請求取得資料就像取得 $_POST['something'] 一樣簡單。而且建立一個請求到使用者的腳本就跟建立一個 HTTP 請求一樣簡單，在大部分的程式開發環境也都已經內建了。事實上，WebHooks 比實作 API 還要簡單。

不過在實作上有了對網路的輸出將會與愈來愈多人採納的 API 所提供的輸入資料互補。當你有了輸入及輸出的資料時，你就有了所有可以與應用程式互動的東西。這會促進更小、更專注特定功能的應用程式與開啟 WebHooks 的多樣化應用程式一起協作，這會讓許多令人驚豔且新興的事件發生！

應該如何實作 WebHooks？

只要你的使用者可以容易地將他們的網址註冊到你的應用程式，而且當某個事件發生時可以把資料使用 POST 請求送到這個網址就行了。非常簡單。不必遵循什麼特定的規格。

真的沒有規格！？

到目前為止還沒有一個針對 WebHooks 的標準，現在有許多組織正在定義指南，或許有一天這些指南會逐步形成一個標準。這每個標準都應該可以用在不同的需求，或是簡單及廣泛的實作。大家可以看看下面這個對不同建議及實作指南的網頁，而且一定要把你的意見或經驗分享給我們。如果你在使用這些建議有一些不好的體驗，或是你覺得這些建議可以做一些調整的時候，快加入這個對話串一起來改善這份規格吧！

誰在使用 WebHooks？

已經有許多人使用過 WebHooks 了。有些是有意識地，有些是出於實用主義。這通常是一個不錯的信號。讓我們一起來加入這個派對加強這個模式吧。

誰應該使用 WebHooks？

  • 線上應用程式平台
    • DabbleDB
    • Coghead
    • Salesforce
    • Ning
  • 記得訂過的牛奶 (我只是想要擴展我使用的 todo 應用程式)
  • Twitter (可以用在任何地方)
  • 任何人...

有一些甚至開始嘗試把 WebHooks 用在桌面應用程式上了。

投影片

有哪些人流行

進一步閱讀

你也可以持續關注 webhooks.org 這個網站，取得更多關於 WebHooks 的最新資訊，或是上 Google Group 一起討論吧！

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].