Influence-cjdns/doc/ru/API.md

114 lines
5.4 KiB
Markdown
Raw Normal View History

2018-05-09 12:27:25 +00:00
# Протокол обмена.
2018-05-09 11:39:18 +00:00
## Структура сети:
2018-05-09 12:27:25 +00:00
2018-05-09 11:39:18 +00:00
Связь между узлами - точка-точка
GUI - Сервер ==== Сервер - GUI
GUI - примитивная программа под Linux/Window/Android, которая умеет отображать сообщения и обмениваться с сервером.
Сервер - как правило сидит на localhost, принимает сообщения от GUI и переправляет на другой сервер.
В Windows/Linux GUI и серверная часть могут быть объединены.
Разделение GUI и Сервера позволяет также отправлять сообщения тем, кто оффлайн (например сервер крутится на роутере и он всё время online).
На сервере также хранится история переписки.
У сервера есть список контактов (друзей), в формате:
2018-05-09 12:27:25 +00:00
2018-05-09 11:54:44 +00:00
```json
2018-05-09 11:39:18 +00:00
{
2018-05-09 11:58:38 +00:00
"адрес1": { "nick":"", "last_online":"", "last_connect":"", "can_resend":1, "key":"", "other_info":... }
2018-05-09 11:39:18 +00:00
...
}
```
2018-05-09 12:27:25 +00:00
Поле адрес - это адрес сервера, куда отправляем. Может быть как ipv4, так и ipv6 адрес в сети cjdns.
2018-05-09 11:39:18 +00:00
## Протокол обмена
2018-05-09 12:27:25 +00:00
2018-05-09 11:39:18 +00:00
Обмен сообщениями ведётся по GET/POST http протоколу в формате JSON, что позволяет делать GUI прямо в браузере.
При любой успешной отправке данных обновляем поле last_connect у контакта.
2018-05-09 12:14:45 +00:00
Если пришло сообщение от контакта, которого нет в адресной книге - то оно отбрасывается.
Исключения - запрос handshake.
2018-05-09 11:39:18 +00:00
2018-05-09 12:31:17 +00:00
### Добавление в друзья
Используется, чтобы установить связь с контактом. Тот кто хочет добавиться в друзья - отправляет такой запрос.
2018-05-09 12:27:25 +00:00
2018-05-09 11:54:44 +00:00
```json
2018-05-11 05:36:06 +00:00
{ "action":"handshake", "peerID": "*IPv6 контакта*" }
2018-05-09 11:39:18 +00:00
```
2018-05-09 12:27:25 +00:00
2018-05-09 12:31:17 +00:00
ответ:
2018-05-09 12:27:25 +00:00
2018-05-09 11:54:44 +00:00
```json
2018-05-09 11:58:38 +00:00
{ "status": 1 }
2018-05-09 11:39:18 +00:00
```
2018-05-09 12:27:25 +00:00
2018-05-09 12:14:45 +00:00
У другого абонента висит этот контакт в списке неавторизованных. Если он хочет его тоже добавить в друзья - отправляем ему свой handshake. Возможет вариант, когда сервер автоматически добавляет в друзья (публичный сервер для пересылки offline сообщений).
2018-05-09 11:39:18 +00:00
2018-05-09 12:23:21 +00:00
### Отправка сообщения
Структура сообщения в JSON:
2018-05-09 11:54:44 +00:00
```json
2018-05-09 12:14:45 +00:00
{ "action":"send", "from":"адрес", "to":"адрес", "message":"сообщение", "timestamp":"время", "enctype":"" }
2018-05-09 11:39:18 +00:00
```
2018-05-09 12:27:25 +00:00
2018-05-09 11:39:18 +00:00
ответ:
2018-05-09 12:27:25 +00:00
2018-05-09 11:54:44 +00:00
```json
2018-05-09 11:58:38 +00:00
{ "status": 1 }
2018-05-09 11:39:18 +00:00
```
2018-05-09 12:27:25 +00:00
2018-05-09 11:39:18 +00:00
Сообщение может быть зашифровано, метод шифрования в поле enctype.
Если нет ответа, то сохраняем сообщение у себя в истории, чтобы потом переотправить.
`status==1` - доставлено, другой - недоставлено (помечаем как недоставлено
2018-05-09 12:23:21 +00:00
### Пинг - проверка онлайна
2018-05-09 11:39:18 +00:00
Если прошло время больше чем last_connect + 1 минута, от отправляем запрос
2018-05-09 12:23:21 +00:00
2018-05-09 11:54:44 +00:00
```json
2018-05-09 11:58:38 +00:00
{ "action":"ping" }
2018-05-09 11:39:18 +00:00
```
2018-05-09 12:27:25 +00:00
2018-05-09 11:39:18 +00:00
ответ:
2018-05-09 12:27:25 +00:00
2018-05-09 11:54:44 +00:00
```json
2018-05-09 11:58:38 +00:00
{ "action":"pong" }
2018-05-09 11:39:18 +00:00
```
2018-05-09 12:23:21 +00:00
Если у нас есть сообщения для адреса и он онлайн (last_connect < 1 минуты), то передаём их
2018-05-09 11:39:18 +00:00
Если для этого адрес в базе есть недоставленные сообщения, то отправляем такой запрос:
2018-05-09 12:23:21 +00:00
2018-05-09 11:54:44 +00:00
```json
2018-05-09 11:58:38 +00:00
{ "action": "history", "messages":[{},{},{}...] }
2018-05-09 11:39:18 +00:00
```
2018-05-09 12:27:25 +00:00
2018-05-09 12:23:21 +00:00
ответ:
2018-05-09 12:27:25 +00:00
2018-05-09 11:54:44 +00:00
```json
2018-05-09 11:58:38 +00:00
{ "status":[1,1,1,0,1] }
2018-05-09 11:39:18 +00:00
```
2018-05-09 12:27:25 +00:00
2018-05-09 11:39:18 +00:00
В ответ приходит массив с 1 или 0. Если 1 - сообщение сохранено успешно, 0 - ошибка и его нужно потом переотправить.
2018-05-09 12:23:21 +00:00
### Отправление сообщения для другого абонента (это нужно чтобы отправлять тем, кто в offline)
Если человек, которому мы отправляем сообщение offline - то, во-первых, оно сохраняется у себя на сервере, для последующей отправки.
Во-вторых, можно попросить какого-то друга его переотправить. Для этого выбираем случайно несколько друзей из списка контактов, у которых `can_resend == 1` и отправляем им запрос.
2018-05-09 11:39:18 +00:00
Для ретрансляции можно также использовать свой сервер в интернете, нужно просто его добавить в контакты.
2018-05-09 12:23:21 +00:00
2018-05-09 11:54:44 +00:00
```json
2018-05-09 11:58:38 +00:00
{ "action":"resend", ... }
2018-05-09 11:39:18 +00:00
```
2018-05-09 12:27:25 +00:00
2018-05-09 11:39:18 +00:00
Параметры такие же как и для send
ответ
2018-05-09 12:27:25 +00:00
2018-05-09 11:54:44 +00:00
```json
2018-05-09 11:58:38 +00:00
{ "status":1 }
2018-05-09 11:39:18 +00:00
```
2018-05-09 12:27:25 +00:00
2018-05-11 05:36:06 +00:00
Если `status == 0` - то эта нода не желает пересылать сообщения и ей повторно отправлять не нужно.