itd-api / NotificationsResource

Interface: NotificationsResource

Defined in: resources/notifications.ts:56

Уведомления: список, счётчик, отметки о прочтении, настройки.

Доступна как itd.notifications. Все уведомления приведены к единой форме, поэтому объекты отсюда и из потока событий можно складывать в один список.

Extends

• BaseResource

Methods

count()

count(options?): Promise<number>;

Defined in: resources/notifications.ts:102

Загружает число непрочитанных уведомлений.

Parameters

options?

RequestOptions = {}

Returns

Promise<number>

---

getSettings()

getSettings(options?): Promise<NotificationSettings>;

Defined in: resources/notifications.ts:167

Загружает настройки уведомлений.

Parameters

options?

RequestOptions = {}

Returns

Promise<NotificationSettings>

---

iterate()

iterate(params?): Paginator<Notification>;

Defined in: resources/notifications.ts:97

Перебирает уведомления.

Parameters

params?

NotificationListParams = {}

Returns

Paginator<Notification>

Example

for await (const notification of itd.notifications.iterate()) {
  console.log(formatNotificationText(notification));
}

---

list()

list(params?): Promise<Page<Notification>>;

Defined in: resources/notifications.ts:83

Загружает страницу уведомлений.

Пагинация здесь основана на смещении.

Parameters

params?

NotificationListParams = {}

Returns

Promise<Page<Notification>>

Example

const page = await itd.notifications.list({ limit: 20 });
const next = await itd.notifications.list({ limit: 20, offset: page.nextOffset });

---

markAllRead()

markAllRead(options?): Promise<number>;

Defined in: resources/notifications.ts:156

Отмечает прочитанными все уведомления.

Parameters

options?

RequestOptions = {}

Returns

Promise<number>

---

markRead()

markRead(notificationId, options?): Promise<number>;

Defined in: resources/notifications.ts:117

Отмечает уведомление прочитанным.

Parameters

notificationId

string

options?

RequestOptions = {}

Returns

Promise<number>

сколько записей отметил сервер

---

markReadBatch()

markReadBatch(ids, options?): Promise<number>;

Defined in: resources/notifications.ts:136

Отмечает прочитанными сразу несколько уведомлений.

Список автоматически режется на части по 20 идентификаторов — столько же отправляет сайт итд.com, поэтому на сервере вероятен предел. Части уходят последовательно, результат суммируется.

Parameters

ids

string[]

options?

RequestOptions = {}

Returns

Promise<number>

сколько записей отметил сервер суммарно

---

updateSettings()

updateSettings(input, options?): Promise<NotificationSettings>;

Defined in: resources/notifications.ts:182

Обновляет настройки уведомлений.

Отправляются только изменяемые поля, в том же виде, в каком сервер их возвращает.

Parameters

input

UpdateNotificationSettingsInput

options?

RequestOptions = {}

Returns

Promise<NotificationSettings>