tent.io/content/docs/server-protocol.md

Tent Server-Server Communication Protocol

This document describes the protocol that Tent servers use to communicate with each other.

Server Discovery

Server discovery is done through HTTP Link headers as well as HTML link tags. Multiple links may be presented, and should be tried by the client in order.

HTTP Link Header

The HTTP header allows discovery of Tent servers by just doing a HEAD request instead of getting the page and parsing it for the link tag. It should be added to all responses associated with the Tent entity.

Link: <https://tent.titanous.com>; rel="https://tent.io/rels/profile"

HTML link tag

The link tag should be placed in the head tag of all HTML pages associated with the Tent entity.

<link href="https://tent.titanous.com" rel="https://tent.io/rels/profile" />

Follow an entity

A follow request is required in order to receive notifications about posts published by an entity.

POST /followers

{create_follower example}

Authentication

All requests should be made using SSL.

Authentication is required to access resources that are not marked as public.

Tent uses MAC Access Authentication for all requests.

All requests must be signed using MAC, and all notifications from the server are signed as well.

Get Current Following

GET /followers/:id

{get_follower example}

Edit Following

PUT /followers/:id

{update_follower example}

Stop Following

DELETE /followers/:id

{delete_follower example}

Notifications

Notification from titanous.com to danielsiders.com that new content has been posted.

Fetch Post Feed

GET /posts

Parameters

Name	Required	Type	Description
post_types	Optional	string	Specifies the post types and views to return. ex: https://tent.io/types/posts/blog#excerpt,https://tent.io/types/posts/photo#meta
since_id	Optional	string	Show posts newer than this id.
before_id	Optional	string	Show posts older than this id.
since_time	Optional	integer	Show posts made since this time (unix epoch time).
before_time	Optional	integer	Show posts made before this time (unix epoch time).
count	Optional	integer	The number of posts to return.