+
+
Alpha Documentation
+
These docs are very rough, incorrect, and incomplete. They will be modified heavily over the next few weeks.
+
Please contribute by making Pull Requests and Issues on the GitHub repository.
+
Server API for Apps
+
+
GET /profile
+
GET /profile HTTP/1.1
+Accept: application/vnd.tent.v0+json
+
+
+
HTTP/1.1 200 OK
+Content-Type: application/vnd.tent.v0+json
+Content-Length: 420
+
+
+
{
+ "https://tent.io/types/info/core/v0.1.0": {
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "entity": "https://example.org",
+ "servers": [
+ "https://tent.example.org",
+ "http://eqt5g4fuenphqinx.onion/"
+ ]
+ },
+ "https://tent.io/types/info/basic/v0.1.0": {
+ "name": "The Tentity",
+ "avatar_url": "http://example.org/avatar.jpg",
+ "birthdate": "2012-08-23",
+ "location": "The Internet",
+ "gender": "Unknown",
+ "bio": "Et repudiandae et itaque."
+ }
+}
+
+
+
+
PUT /profile/:type
+
PUT /profile/https%3A%2F%2Ftent.io%2Ftypes%2Finfo%2Fbasic%2Fv0.1.0 HTTP/1.1
+Content-Type: application/vnd.tent.v0+json
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="u:083dc7a9", ts="1346984266", nonce="53958a", mac="tyDhHq7ys5JWbXRbunucJt10Hr1GpJxQWZRfGWm9Abs="
+
+
+
{
+ "name": "The Tentity",
+ "avatar_url": "http://example.org/avatar.jpg",
+ "birthdate": "2012-08-23",
+ "location": "The Internet",
+ "gender": "Unknown",
+ "bio": "Exercitationem perferendis voluptatem ad dolorem velit dolores cumque vero."
+}
+
+
+
HTTP/1.1 200 OK
+Content-Type: application/vnd.tent.v0+json
+Content-Length: 470
+
+
+
{
+ "https://tent.io/types/info/core/v0.1.0": {
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "entity": "https://example.org",
+ "servers": [
+ "https://tent.example.org",
+ "http://eqt5g4fuenphqinx.onion/"
+ ]
+ },
+ "https://tent.io/types/info/basic/v0.1.0": {
+ "name": "The Tentity",
+ "avatar_url": "http://example.org/avatar.jpg",
+ "birthdate": "2012-08-23",
+ "location": "The Internet",
+ "gender": "Unknown",
+ "bio": "Exercitationem perferendis voluptatem ad dolorem velit dolores cumque vero."
+ }
+}
+
+
+
+
POST /followings
+
POST /followings HTTP/1.1
+Content-Type: application/vnd.tent.v0+json
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="u:083dc7a9", ts="1346984266", nonce="9aa86d", mac="Phkn5uHbA4vZxUFxTRDYV+XdqyH/fd6VG8DR41aIKn4="
+
+
+
{
+ "entity": "https://example.org"
+}
+
+
+
HTTP/1.1 200 OK
+Content-Type: application/vnd.tent.v0+json
+Content-Length: 211
+
+
+
{
+ "remote_id": "eazohw",
+ "entity": "https://example.org",
+ "permissions": {
+ "groups": [
+
+ ],
+ "entities": {
+ },
+ "public": false
+ },
+ "id": "icb7x0",
+ "created_at": 1346984266,
+ "updated_at": 1346984266,
+ "groups": [
+
+ ],
+ "profile": {
+ },
+ "licenses": [
+
+ ]
+}
+
+
+
+
GET /followings
+
GET /followings HTTP/1.1
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="u:083dc7a9", ts="1346984266", nonce="5fb6eb", mac="rT3N3hbziQMelFZrq3dzLoyBJhvPd5NUiJ4wPumY30A="
+
+
+
HTTP/1.1 200 OK
+Content-Type: application/vnd.tent.v0+json
+Last-Modified: Fri, 07 Sep 2012 02:17:46 GMT
+Cache-Control: private
+Content-Length: 213
+
+
+
[
+ {
+ "remote_id": "eazohw",
+ "entity": "https://example.org",
+ "permissions": {
+ "groups": [
+
+ ],
+ "entities": {
+ },
+ "public": false
+ },
+ "id": "icb7x0",
+ "created_at": 1346984266,
+ "updated_at": 1346984266,
+ "groups": [
+
+ ],
+ "profile": {
+ },
+ "licenses": [
+
+ ]
+ }
+]
+
+
+
+
GET /followings/:id
+
GET /followings HTTP/1.1
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="u:083dc7a9", ts="1346984266", nonce="5fb6eb", mac="rT3N3hbziQMelFZrq3dzLoyBJhvPd5NUiJ4wPumY30A="
+
+
+
HTTP/1.1 200 OK
+Content-Type: application/vnd.tent.v0+json
+Last-Modified: Fri, 07 Sep 2012 02:17:46 GMT
+Cache-Control: private
+Content-Length: 213
+
+
+
[
+ {
+ "remote_id": "eazohw",
+ "entity": "https://example.org",
+ "permissions": {
+ "groups": [
+
+ ],
+ "entities": {
+ },
+ "public": false
+ },
+ "id": "icb7x0",
+ "created_at": 1346984266,
+ "updated_at": 1346984266,
+ "groups": [
+
+ ],
+ "profile": {
+ },
+ "licenses": [
+
+ ]
+ }
+]
+
+
+
+
DELETE /followings/:id
+
DELETE /followings/icb7x0 HTTP/1.1
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="u:083dc7a9", ts="1346984266", nonce="681e1c", mac="4fOAdx3lv4Yz/xwDRWnui5RXvUbgjbLLajG1jCXMZeQ="
+
+
+
HTTP/1.1 200 OK
+Content-Type: text/html
+Content-Length: 0
+
+
+
+
GET /followers
+
GET /followers HTTP/1.1
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="u:083dc7a9", ts="1346984266", nonce="867d51", mac="s72ysBXjISmuyTEsL0XMymcBgL67kxLHetvdpn5no/s="
+
+
+
HTTP/1.1 200 OK
+Content-Type: application/vnd.tent.v0+json
+Last-Modified: Fri, 07 Sep 2012 02:17:46 GMT
+Cache-Control: private
+Content-Length: 1432
+
+
+
[
+ {
+ "entity": "https://example.org",
+ "permissions": {
+ "groups": [
+
+ ],
+ "entities": {
+ },
+ "public": false
+ },
+ "id": "7m3dto",
+ "created_at": 1346984266,
+ "updated_at": 1346984266,
+ "groups": [
+
+ ],
+ "profile": {
+ "https://tent.io/types/info/core/v0.1.0": {
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "entity": "https://example.org",
+ "servers": [
+ "https://tent.example.org",
+ "http://eqt5g4fuenphqinx.onion/"
+ ]
+ },
+ "https://tent.io/types/info/basic/v0.1.0": {
+ "name": "The Tentity",
+ "avatar_url": "http://example.org/avatar.jpg",
+ "birthdate": "2012-08-23",
+ "location": "The Internet",
+ "gender": "Unknown",
+ "bio": "Et repudiandae et itaque."
+ }
+ },
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "types": [
+ "https://tent.io/types/post/essay/v0.1.0#full"
+ ]
+ },
+ {
+ "entity": "https://example.org",
+ "permissions": {
+ "groups": [
+
+ ],
+ "entities": {
+ },
+ "public": false
+ },
+ "id": "eazohw",
+ "created_at": 1346984266,
+ "updated_at": 1346984266,
+ "groups": [
+
+ ],
+ "profile": {
+ "https://tent.io/types/info/core/v0.1.0": {
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "entity": "https://example.org",
+ "servers": [
+ "https://tent.example.org",
+ "http://eqt5g4fuenphqinx.onion/"
+ ]
+ },
+ "https://tent.io/types/info/basic/v0.1.0": {
+ "name": "The Tentity",
+ "avatar_url": "http://example.org/avatar.jpg",
+ "birthdate": "2012-08-23",
+ "location": "The Internet",
+ "gender": "Unknown",
+ "bio": "Exercitationem perferendis voluptatem ad dolorem velit dolores cumque vero."
+ }
+ },
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "types": [
+ "all"
+ ]
+ }
+]
+
+
+
+
GET /followers/:id
+
GET /followers/7m3dto HTTP/1.1
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="s:16e9933f", ts="1346984266", nonce="3824e1", mac="aRnrSo+80AHRru2FJE1Sj6GfCsmpKcyv7w5FZONAtOM="
+
+
+
HTTP/1.1 200 OK
+Content-Type: application/vnd.tent.v0+json
+Last-Modified: Fri, 07 Sep 2012 02:17:46 GMT
+Cache-Control: private
+Content-Length: 152
+
+
+
{
+ "entity": "https://example.org",
+ "permissions": {
+ "public": false
+ },
+ "id": "7m3dto",
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "types": [
+ "all"
+ ]
+}
+
+
+
+
DELETE /followers/:id
+
DELETE /followers/eazohw HTTP/1.1
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="s:16e9933f", ts="1346984266", nonce="fa20ba", mac="SkbEBnIsBUvZ9jLce6cXfry7dqNN9OELnnF1UvwkHys="
+
+
+
HTTP/1.1 403 Forbidden
+Content-Type: text/html
+Content-Length: 12
+
+
+
+
+
POST /posts
+
POST /posts HTTP/1.1
+Content-Type: application/vnd.tent.v0+json
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="u:083dc7a9", ts="1346984266", nonce="25d6b6", mac="En8hMilWUOdUKaaKBbGduhsSKU/a/01NmlPd/knxf4w="
+
+
+
{
+ "type": "https://tent.io/types/post/status/v0.1.0",
+ "published_at": 1346984266,
+ "permissions": {
+ "public": true
+ },
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "content": {
+ "text": "Just landed.",
+ "location": {
+ "type": "Point",
+ "coordinates": [
+ 50.923878,
+ 4.028605
+ ]
+ }
+ }
+}
+
+
+
HTTP/1.1 200 OK
+Content-Type: application/vnd.tent.v0+json
+Content-Length: 471
+
+
+
{
+ "entity": "https://example.org",
+ "type": "https://tent.io/types/post/status/v0.1.0",
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "content": {
+ "text": "Just landed.",
+ "location": {
+ "type": "Point",
+ "coordinates": [
+ 50.923878,
+ 4.028605
+ ]
+ }
+ },
+ "published_at": 1346984266,
+ "permissions": {
+ "groups": [
+
+ ],
+ "entities": {
+ },
+ "public": true
+ },
+ "id": "xk3mlq",
+ "updated_at": 1346984266,
+ "received_at": 1346984266,
+ "app": {
+ "url": "http://example.com",
+ "name": "FooApp"
+ },
+ "attachments": [
+
+ ],
+ "known_entity": null
+}
+
+
+
+
GET /posts
+
GET /posts HTTP/1.1
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="u:083dc7a9", ts="1346984266", nonce="c45f60", mac="gGFV+/u8vMxq0Inp40dlzyN40k9Y1YNriznzv7QKKOA="
+
+
+
HTTP/1.1 200 OK
+Content-Type: application/vnd.tent.v0+json
+Last-Modified: Fri, 07 Sep 2012 02:17:46 GMT
+Cache-Control: private
+Content-Length: 473
+
+
+
[
+ {
+ "entity": "https://example.org",
+ "type": "https://tent.io/types/post/status/v0.1.0",
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "content": {
+ "text": "Just landed.",
+ "location": {
+ "type": "Point",
+ "coordinates": [
+ 50.923878,
+ 4.028605
+ ]
+ }
+ },
+ "published_at": 1346984266,
+ "permissions": {
+ "groups": [
+
+ ],
+ "entities": {
+ },
+ "public": true
+ },
+ "id": "xk3mlq",
+ "updated_at": 1346984266,
+ "received_at": 1346984266,
+ "app": {
+ "url": "http://example.com",
+ "name": "FooApp"
+ },
+ "attachments": [
+
+ ],
+ "known_entity": null
+ }
+]
+
+
+
+
GET /posts/:id
+
GET /posts/xk3mlq HTTP/1.1
+Accept: application/vnd.tent.v0+json
+Authorization: MAC id="u:083dc7a9", ts="1346984266", nonce="026f07", mac="mvVK92nXEX8XQor+x4nH46OcvtopAX8YHJwiiylH8r0="
+
+
+
HTTP/1.1 200 OK
+Content-Type: application/vnd.tent.v0+json
+Last-Modified: Fri, 07 Sep 2012 02:17:46 GMT
+Cache-Control: public
+Content-Length: 471
+
+
+
{
+ "entity": "https://example.org",
+ "type": "https://tent.io/types/post/status/v0.1.0",
+ "licenses": [
+ "http://creativecommons.org/licenses/by/3.0/"
+ ],
+ "content": {
+ "text": "Just landed.",
+ "location": {
+ "type": "Point",
+ "coordinates": [
+ 50.923878,
+ 4.028605
+ ]
+ }
+ },
+ "published_at": 1346984266,
+ "permissions": {
+ "groups": [
+
+ ],
+ "entities": {
+ },
+ "public": true
+ },
+ "id": "xk3mlq",
+ "updated_at": 1346984266,
+ "received_at": 1346984266,
+ "app": {
+ "url": "http://example.com",
+ "name": "FooApp"
+ },
+ "attachments": [
+
+ ],
+ "known_entity": null
+}
+
+
+