A Time Stream response can be returned at any url. In this example,
there's a /status
endpoint that's the url for a stream
of Twitter-like status posts.
The response is a regular HTTP response that includes the most recent post to the stream, plus some additional metadata via HTTP headers.
GET
/status
There are three headers required for the Time Streams protocol:
Time-Streams-Version
, Post-Time
, and
Link
.
Time-Streams-Version
is the version of the Time Streams
protocol that the server's using.
Post-Time
is the logical time for this post. That's
typically the time it was created, but it can be something else, like
the date associated with the resource. (Imagine a timeline, for example.)
It uses the HTTP-date format.
Link
is an existing standard HTTP header described in
the Web Linking RFC.
The "self" relation is the permalink for this post, and the "previous"
relation is the url for the previous post in the stream, if there is one. Additional
metadata, like a title, may be provided via attributes of the link header entries.