Cozy

Cozy's Virtual hub

Guzzle Ayup! allows Cozy to send realtime notifications when new content is published. All thanks to the open PubSubHubbub protocol.

Want to learn more about Guzzle Ayup! and how you too can let everyone know instantly when you publish new content? Visit Guzzle Ayup! now.

Want to receive realtime notification when Cozy's publishes a new story?

  1. To start with, send a HTTP POST request to: http://.ayup.us with the following parameters:
    • hub.mode: Required String The literal string "subscribe".
    • hub.callback: Required url The URL of your HTTP callback.
    • hub.topic: Required url The URL of the feed you want to subscribe to.
    • hub.verify: Required String Either "sync" or "async" (can be repeated, see below).
    • hub.secret: Optional String A secret string that will be used to compute an HMAC digest of the content for every notification.
    • hub.verify_token: Optional String A token that will be echoed back in the verification request to assist the subscriber in identifying which subscription request is being verified.
  2. To verify your intent, the hub will in turn send an HTTP GET request to the HTTP callback you specified.
  3. The hub will respond to a subscription request with an HTTP 204 No Content response if the request was verified, and with an HTTP 202 Accepted response if the subscription has yet to be verified in the case of an "async" verification mode.
  4. If an error occured while subscribing, the hub will respond with an HTTP 400 Bad Request response with the description of the error in the response body.
  5. Notifications will be sent to your HTTP callback via a HTTP POST request with a body consisting of an Atom feed document listing new and updated entries.

Want more information? You can consult Guzzle Ayup! documentation.