diff --git a/API.md b/API.md index 8ec7a0a..247ba61 100644 --- a/API.md +++ b/API.md @@ -25,22 +25,23 @@ GUI - примитивная программа под Linux/Window/Android, к ## Протокол обмена Обмен сообщениями ведётся по GET/POST http протоколу в формате JSON, что позволяет делать GUI прямо в браузере. При любой успешной отправке данных обновляем поле last_connect у контакта. -Во всех сообщениях нужно указывать ключ, если он не подойдёт - то сообщение отбрасывается. +Если пришло сообщение от контакта, которого нет в адресной книге - то оно отбрасывается. +Исключения - запрос handshake. 1. Добавление в друзья -Используется, чтобы установить связь с контактом. Для этого запрашиваем у него ключ доступа, предварительно отправив свой. +Используется, чтобы установить связь с контактом. Тот кто хочет добавиться в друзья - отправляет такой запрос. ```json -{ "action":"handshake", "key":"пароль" } +{ "action":"handshake", "nick": "" } ``` ответ ```json { "status": 1 } ``` -Когда один отправил запрос - то второй может отправить свой ключ и тогда сервера смогут общаться друг с другом. +У другого абонента висит этот контакт в списке неавторизованных. Если он хочет его тоже добавить в друзья - отправляем ему свой handshake. Возможет вариант, когда сервер автоматически добавляет в друзья (публичный сервер для пересылки offline сообщений). 2. Отправка сообщения: ```json -{ "action":"send", "from":"адрес", "to":"адрес", "message":"сообщение", "timestamp":"время", "enctype":"", "key":"" } +{ "action":"send", "from":"адрес", "to":"адрес", "message":"сообщение", "timestamp":"время", "enctype":"" } ``` ответ: ```json