Получить список цепочек сообщений
GET /message-threads
Получает список цепочек сообщений.
Примеры запросов
curl -X GET 'https://tasks.yandex.ru/api/v1/message-threads?folder=INBOX,UNREAD' \
-H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'
import requests
url = "https://tasks.yandex.ru/api/v1/message-threads"
params = {
'folder': 'INBOX,UNREAD'
}
headers = {
'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
}
response = requests.get(url, params=params, headers=headers)
print(response.text)
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://tasks.yandex.ru/api/v1/message-threads',
'qs': {'folder': 'INBOX,UNREAD'},
'headers': {
'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Заголовки
Заголовок |
Описание |
|
API-токен для авторизации аккаунта. В качестве префикса добавьте |
Query-параметры
Указываются в ссылке после знака вопроса, перечисляются через &
.
Параметр |
Описание |
|
string Папки, в которых находится цепочка:
Можно указать несколько значений через запятую. |
|
string Папки, в которых не искать цепочку:
Можно указать несколько значений через запятую. |
|
string Параметры для сортировки:
О том, как задать сортировку, читайте на странице Сортировка списка объектов. |
|
integer Ограничение на количество возвращаемых результатов. По умолчанию — 50, максимум — 300. |
|
string Объекты с идентификатором больше указанного значения. |
|
string Объекты с идентификатором больше или равным указанному значению. |
|
string Объекты с идентификатором меньше указанного значения. |
|
string Объекты с идентификатором меньше или равным указанному значению. |
|
string Объекты, выданные или созданные после указанной даты. |
|
string Объекты, выданные или созданные после указанной даты включительно. |
|
string Объекты, выданные или созданные до указанной даты. |
|
string Объекты, выданные или созданные до указанной даты включительно. |
Ответ
Содержит список цепочек сообщений в массиве items
:
{
"items": [
{message thread details 1},
{message thread details 2},
...
{message thread details n}
],
"has_more": false
}
Пример ответа
{
"items": [
{
"id": "643933af08583e0a19c2167e",
"topic": {
"EN": "Test bonus"
},
"interlocutors_inlined": true,
"interlocutors": [
{
"id": "6c6e20dc86cca2ae787afcb2629de162",
"role": "REQUESTER",
"myself": true
},
{
"id": "a1b0b42923c429daa2c764d7ccfc364d",
"role": "USER"
}
],
"messages_inlined": true,
"messages": [
{
"text": {
"EN": "Thank you"
},
"from": {
"id": "6c6e20dc86cca2ae787afcb2629de162",
"role": "REQUESTER",
"myself": true
},
"created": "2023-04-14T11:06:23.096"
}
],
"compose_details": {
"recipients_select_type": "DIRECT",
"recipients_ids": [
"a1b0b42923c429daa2c764d7ccfc364d\""
]
},
"meta": {},
"folders": [
"OUTBOX"
],
"answerable": false,
"created": "2023-04-14T11:06:23.096"
}
],
"has_more": true
}
Параметр |
Описание |
|
array of objects Массив со списком цепочек сообщений и их свойств. |
|
boolean Показывает, является ли список элементов в ответе полным. Возможные значения:
|