Changes between Version 7 and Version 8 of HTTP_Interface

Timestamp:

03/02/2008 14:51:37 (5 years ago)

Author:

ralphm

Comment:

--

HTTP_Interface

@@ -88 +88 @@
 == Subscribing to remote nodes and receiving notifications ==
 
-To subscribe from the local service to changes to remote resources though HTTP, the gateway has a publish-subscribe client and exposes it through HTTP. The HTTP client provides the XMPP URI of the (remote) node, and a callback URI. The latter is used to `POST` Atom Entry documents embedded in notifications received from the subscribed node to.
+To subscribe from the local service to changes to remote resources though HTTP, the gateway has a publish-subscribe client and exposes it through HTTP. The HTTP client provides the XMPP URI of the (remote) node, and a callback URI. The latter is used to forward received notifications for the node by performing a `POST` request on the URI.
+
+Notifications can be about new or updated items for that node, or the deletion of the node. In case of item notifications, an Atom Entry  document or Atom Feed document is the embedded entity in the request. For node deletion, the `POST` request does not carry an entity, but has the `Event` header set to `DELETED`.
 
 [[Image(gatewayed_subscription.png)]]
@@ -178 +180 @@
 
 For now, the response to the HTTP request is ignored, but at some point it might be used to retry the notification on temporary failure or unsubscription on permanent failure.
+
+{{{
+POST /other_callback HTTP/1.1
+Host: localhost
+Content-Type: application/atom+xml;type=feed;charset=utf-8
+Content-Length: 509
+Referer: xmpp:example.com;?node=news_feed
+
+<feed xmlns="http://www.w3.org/2005/Atom">
+  <entry>
+    <title>Item1</title>
+    <id>urn:uuid:4c22de69-ad82-49d7-820d-1d1ccee87b4a</id>
+    <updated>2008-03-02T13:49:01Z</updated>
+    <author><name>Jane Doe</name></author>
+    <content>Some text.</content>
+  </entry>
+  <entry>
+    <title>Item2</title>
+    <id>urn:uuid:0deddff7-8ff3-4e6a-a0eb-52a08cc588f1</id>
+    <updated>2008-03-02T13:49:03Z</updated>
+    <author><name>Jane Doe</name></author>
+    <content>Some other text.</content>
+  </entry>
+</feed>
+}}}