updated api

This commit is contained in:
Андреев Григорий 2024-08-25 23:20:35 +03:00
parent 93d7060089
commit 641b35f519

17
api.typ
View File

@ -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)