Note well: There is no guarantee of API stability until Tent v1.0.
Please contribute by making Pull Requests and Issues on the GitHub repository.
Each entity is identified by a Entity URL. This URL used to discover the meta post that describes the servers that represent the entity. The entity URL may be any standard HTTP/HTTPS URL that has no query parameters or fragment.
Discovery is the process of taking an Entity URL and finding the associated meta post in order to locate the servers that represent the entity.
There are two discovery methods, both utilizing Web
Linking to point to the meta post. The
preferred method is a HTTP
Link header presented in response to a
GET request to the Entity URL. Alternatively, a HTML document may be served
link tag. The
rel used is
links may be provided, the first one that has a
200 response status with
a valid meta post should be used.
HEAD / HTTP/1.1
HTTP/1.1 200 OK Link: </posts/http%3A%2F%2Fbb216a47d970.alpha.attic.is/meta>; rel="https://tent.io/rels/meta-post"
GET / HTTP/1.1
<!-- ... --> <link href="https://mytent.example.com/posts/aaf43" rel="https://tent.io/rels/meta-post"/> <!-- ... -->