u/bodqhrohro/swineboard Commit - r759:f8457e6d

1

# INTRO #

1

# INTRO #

2

3

This document discribes the server sync protocol.

3

This document discribes the server sync protocol.

4

5

# DRAFT PROTOCOL DESCRIPTION #

5

# DRAFT PROTOCOL DESCRIPTION #

6

7

Version:

7

Version:

8

* Protocol version

8

* Protocol version

9

* Model version

9

* Model version

10

11

Node data:

11

Node data:

12

* Public key

12

* Public key

13

14

Object data:

14

Object data:

15

* Post

15

* Post

16

* Post list (for sync)

16

* Post list (for sync)

17

18

The node requests other node's changes list since some time (since epoch if

18

The node requests other node's changes list since some time (since epoch if

19

this is the start). The other node sends a list of post ids or posts in the

19

this is the start). The other node sends a list of post ids or posts in the

20

XML or JSON format.

20

XML or JSON format.

21

22

Protocol version is the version of the sync api. Model version is the version

22

Protocol version is the version of the sync api. Model version is the version

23

of data models. If at least one of them is different, the sync cannot be

23

of data models. If at least one of them is different, the sync cannot be

24

performed.

24

performed.

25

26

The node signs the data with its key. The receiving node saves the key at the

26

The node signs the data with its key. The receiving node saves the key at the

27

first sync and checks it every time. If the key has changed, the info won't be

27

first sync and checks it every time. If the key has changed, the info won't be

28

saved from the node (or the node id must be changed).

28

saved from the node (or the node id must be changed).

29

30

Each node holds a list of networks it wants to get info from.

31

32

Each post has an ID in the unique format: node-id/post-id

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

             # INTRO #
             This document discribes the server sync protocol.
             # DRAFT PROTOCOL DESCRIPTION #
             Version:
             * Protocol version
             * Model version
             Node data:
             * Public key
             Object data:
             * Post
             * Post list (for sync)
             The node requests other node's changes list since some time (since epoch if
             this is the start). The other node sends a list of post ids or posts in the
             XML or JSON format.
             Protocol version is the version of the sync api. Model version is the version
             of data models. If at least one of them is different, the sync cannot be
             performed.
             The node signs the data with its key. The receiving node saves the key at the
             first sync and checks it every time. If the key has changed, the info won't be
             saved from the node (or the node id must be changed).
+            Each node holds a list of networks it wants to get info from.
+            Each post has an ID in the unique format: node-id/post-id