From 520079017d13f375930d0d4fee19e52f117f8993 Mon Sep 17 00:00:00 2001
From: Denis Zheleztsov <d_zheleztsov@wargaming.net>
Date: Tue, 12 Mar 2019 13:30:37 +0300
Subject: [PATCH] Client protocol draft

---
 README.org | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/README.org b/README.org
index 039789c..2f71c1f 100644
--- a/README.org
+++ b/README.org
@@ -67,3 +67,52 @@ Vasya                                          # Имя пользователя
 *** TODO Формат node2node API
 
 *** TODO Формат client API
+
+Т.к. мы используем теги, то API отправки сообщения можно не менять, но поменять конечный эндпоинт,
+вынеся его в расширения протокола.
+
+Т.е.:
+#+begin_src sh
+curl -XPOST -d 'pauth=authstring' -d 'tmsg=BASE64' http://node.domain.tld/x/m/point
+# Либо
+curl -XGET http://node.domain.tld/x/m/point/authstring/BASE64
+#+end_src
+
+А для получения сообщений адресованных вам делаем запрос вида
+#+begin_src sh
+curl -XGET http://node.domain.tld/x/m/mail/authstring
+# Либо
+curl -XPOST -d 'pauth=authstring' http://node.domain.tld/x/m/
+# Получение сообщений со сдвигом
+curl -XPOST -d 'pauth=authstring' http://node.domain.tld/x/m/-10:10
+#+end_src
+
+Т.к. нода по authstring может узнать информацию о поинте, то она должна знать о том
+какие сообщения адресованные этому поинту есть на этой ноде и возвращает их.
+
+Так, ответ от ноды предлагается сделать аналогичным ~/u/e~:
+#+begin_src sh
+curl -XPOST -d 'pauth=authstring' http://node.domain.tld/x/m/-1:1
+HTTP/1.1 200 Ok
+Content-Type: text/plain
+dynamic,1
+IZXhLBKJx0rhx0lXYu3L
+#+end_src
+
+Получаем это сообщение
+#+begin_src sh
+curl -XPOST -d 'pauth=authstring' http://node.domain.tld/x/m/IZXhLBKJx0rhx0lXYu3L
+HTTP/1.1 200 Ok
+Content-Type: text/plain
+IZXhLBKJx0rhx0lXYu3L:BASE64
+#+end_src
+
+Либо несколько сообщений, по аналогии с существующей схемой ~/u/e~
+#+begin_src sh
+curl -XPOST -d 'pauth=authstring' http://node.domain.tld/x/m/IZXhLBKJx0rhx0lXYu3L/IZahLHKJ10rZx0ZXAAA0/...
+HTTP/1.1 200 Ok
+Content-Type: text/plain
+IZXhLBKJx0rhx0lXYu3L:BASE64
+IZahLHKJ10rZx0ZXAAA0:BASE64
+...:BASE64
+#+end_src