summaryrefslogtreecommitdiffstats
path: root/docs/rfc.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/rfc.md')
-rw-r--r--docs/rfc.md14
1 files changed, 13 insertions, 1 deletions
diff --git a/docs/rfc.md b/docs/rfc.md
index 3336cd4..b5fa585 100644
--- a/docs/rfc.md
+++ b/docs/rfc.md
@@ -243,6 +243,19 @@ example: joining, leaving or setting privilages.
| 0x00 | none |
| 0x01 | in_channel |
+### GetHistory
+
+Read messages previously send to a specific channel. User has to member of the channel to perform this action. *since* field specifies start of time range for which history should be retrieved. *count* specifes how many messages should be returned in a single response. *GetHistory* is a locking sequence and it cannot be cancelled while in progress so *count* should be set relatively low. To get more messages use multiple requests with incremented *offset*.
+
+Response is just a sequence of *Message*. Client should use *Timestamp* field of a *Message* to show them in corrent order.
+
+| Type | Name |
+|-----------|--------------|
+| string | channel_name |
+| timestamp | since |
+| int64 | count |
+| int64 | offset |
+
### Test
Test payload is used for encoder and decoders testing. Clients and servers
@@ -300,7 +313,6 @@ Exchanging messages between SOLEC servers is a core concept behind the project.
Sending message to user residing on a different server require estabilishing a
connection between both servers.
-
### Authentication
Server authentication is crucial to prevent message spoofing and other forms of