← home

Time Stream response

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.

Example request




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.

Traversing history →