Уведомления

Получение списка уведомлений

Параметры

HTTP метод	Права доступа	URL	Параметры	Примечание
GET	web_notificator	`https://api.admitad.com/web_notificator/v1/web_notificator/`	Список параметров для запроса	Возвращает список доступных уведомлений*.

* Возвращает результат в формате JSON.

Список параметров для запроса

Название	Тип	Допустимые значения	Примечание
category	char	finance — Финансы system — Система promotions — Промоакции other — Другое Пример: ?category=finance	Возвращает уведомления с указанной категорией.
status	char	not_read — Не прочитано read — Прочитано Пример: ?status=read	Возвращает уведомления с указанным статусом.
start_date	string	Пример: ?start_date=%d.%m.%Y %H:%M:%S	Возвращает уведомления, которые были получены, начиная с указанной даты.
end_date	string	Пример: ?end_date=%d.%m.%Y %H:%M:%S	Возвращает уведомления, которые были получены до указанной даты.
search	string	Пример: ?search=test_subject	Поиск по заголовку уведомления.
limit	integer	Параметры limit, offset
offset	integer	Параметры limit, offset

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token -X GET https://api.admitad.com/web_notificator/v1/web_notificator/

Пример ответа API-сервера в формате JSON:

{

    "id": 6,

    "status": "finance",

    "category": "read",

    "when_read": null,

    "date_created": '15.02.2021 16:08:40',

    "translate": {

        "id": 5,

        "subject": "dsf",

        "text": "sdfsd"

    }

}

Описание полей ответа API-сервера

Название	Тип	Описание
id	int	Идентификатор уведомления
status	char	Статус уведомления. Пример: not_read — Не прочитано read — Прочитано
category	char	Категория уведомления
when_read	datetime	Дата прочтения уведомления. Формат: %Y-%m-%dT%H:%M:%S Пример: 2020-12-02T17:15:28
date_created	datetime	Дата получения уведомления. Формат: %Y-%m-%dT%H:%M:%S Пример: 2020-12-02T17:15:28
translate	object	Объект с информацией об уведомлении.

Параметры объекта translate

Название	Тип	Описание
id	int	Идентификатор объекта.
subject	char	Заголовок уведомления.
text	char	Текст уведомления.

Описание полей ответа API-сервера

Название	Тип	Описание
id	int	Идентификатор уведомления
status	char	Статус уведомления. Пример: not_read — Не прочитано read — Прочитано
category	char	Категория уведомления
when_read	datetime	Дата прочтения уведомления. Формат: %Y-%m-%dT%H:%M:%S Пример: 2020-12-02T17:15:28
date_created	datetime	Дата получения уведомления. Формат: %Y-%m-%dT%H:%M:%S Пример: 2020-12-02T17:15:28
translate	object	Объект с информацией об уведомлении.

Изменение уведомления

Параметры

HTTP метод	Права доступа	URL	Параметры	Примечание
POST	web_notificator	`https://api.admitad.com/web_notificator/v1/web_notificator/{id}/mark_as_read/`		Возвращает обновленное уведомление, где id — это идентификатор уведомления*.

* Возвращает результат в формате JSON.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -H "Content-Type: application/json" -X POST https://api.admitad.com/web_notificator/v1/web_notificator/63/mark_as_read/'

Пример ответа API-сервера в формате JSON:

{

    "id": 6,

    "status": "read",

    "category": "finance",

    "when_read": "2020-12-02T17:15:28",

    "date_created": '15.02.2021 16:08:40',

    "translate": {

        "id": 5,

        "subject": "dsf",

        "text": "sdfsd"

    }

}

Описание полей ответа API-сервера

Название	Тип	Описание
id	int	Идентификатор уведомления
status	char	Статус уведомления. Пример: not_read — Не прочитано read — Прочитано
category	char	Категория уведомления
when_read	datetime	Дата прочтения уведомления. Формат: %Y-%m-%dT%H:%M:%S Пример: 2020-12-02T17:15:28
date_created	datetime	Дата получения уведомления. Формат: %Y-%m-%dT%H:%M:%S Пример: 2020-12-02T17:15:28
translate	object	Объект с информацией об уведомлении.

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

Параметры

HTTP метод	Права доступа	URL	Параметры	Примечание
POST	web_notificator	`https://api.admitad.com/web_notificator/v1/web_notificator/mark_all_as_read/`		Отмечает все уведомления как прочитанные.

* Возвращает статус-код 200 с пустым телом ответа.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token -X POST https://api.admitad.com/web_notificator/v1/web_notificator/mark_all_as_read/