From 641b35f5197da6fd94ec51c02be2a8ab287e137b Mon Sep 17 00:00:00 2001 From: Andreev Gregory Date: Sun, 25 Aug 2024 23:20:35 +0300 Subject: [PATCH] updated api --- api.typ | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/api.typ b/api.typ index 1a5df24..0858ce1 100644 --- a/api.typ +++ b/api.typ @@ -297,12 +297,16 @@ roleHere указывает роль залогиненного пользова #Heading([Получение соседей сообщения], 3) #bigrect[ - - URI: #uritxt("/internalapi/getMessageNeighboursInfo") \ + - URI: #uritxt("/internalapi/getMessageNeighbours") \ - Отправить: \ `Sent["chatId"] = Integer` \ - `Sent["id"] = Integer` #funnyArrow Выбираем нужное сообщение в чате \ - `Sent["direction"] = "backward" / "forward"` \ `Sent["amount"] = Integer` \ + А далее либо \ + `Sent["direction"] = "forward"` \ + `Sent["id"] = Integer` #funnyArrow id сообщения, от которого начинается отсчет \ + Либо \ + `Sent["direction"] = "backward"` \ + `Sent["previousMsgId"] = Integer` - Получить: \ `Recv["messages"] = Array` \ Его элементы это ID сообщения и контент сообщения. \ @@ -316,7 +320,12 @@ roleHere указывает роль залогиненного пользова Можно узнать соседей сообщения "сверху и снизу". Направление `"backward"` покажет $n$ сообщений до переданного сообщения (они будут расположены в списке в обратном порядке), направление `"forward"` покажет $n$ сообщений до указанного. Здесь $n$ это выбранное клиентом -количество желаемых сообщений (`Sent["amount"]`). Сервер ОБЯЗАН вернуть ровно $n$ сообщений, +количество желаемых сообщений (`Sent["amount"]`). +Если направление forward, то нужно указать id сообщения, чьих соседей мы ищем. +Если направление baackward, то нужно указать id ПРЕДЫДУЩЕГО сообщения, относительно +нашего сообщения. Т.е. в ответ войдёт id сообщения, которое мы указали. Можно указать +-1, тогда точно не вернётся ничего и это не ошибка. +Сервер ОБЯЗАН вернуть ровно $n$ сообщений, если они есть и ОБЯЗАН вернуть все сообщения до определённого края истории чата, если край достигнут. #Heading([Запросы изменения состояния одного чата], 2)