Gigma

Уведомления клиента

Метод возвращает уведомления текущего клиента в текущем Application. Передавайте App Token приложения и Bearer token клиента вместе.

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

Метод
GET
URL
https://api.gigma.ru/api/counterparty/notifications
Авторизация
App Token + Bearer token
Headers
Token: {application_token}; Authorization: Bearer {counterparty_token}
Успешный ответ
200

Параметры запроса

  • page (integer, опционально) — номер страницы, начиная с 1.
  • per_page (integer, опционально) — количество уведомлений на странице. По умолчанию 10, максимум 50.

Пример запроса

GET /api/counterparty/notifications?page=1&per_page=10 HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Authorization: Bearer <counterparty_token>
Accept: application/json

Ответ

При успешном действии возвращается HTTP код 200.

{
    "notifications": [
        {
            "id": 1,
            "icon": null,
            "title": "Не удалось продлить подписку",
            "status": "subscription.charge_failed",
            "body": "Проверьте способ оплаты и повторите платёж.",
            "action_url": "/account/subscriptions/42",
            "created_at": "2026-07-30T03:15:00+00:00"
        }
    ],
    "pagination": {
        "total": 1,
        "per_page": 10,
        "current_page": 1,
        "last_page": 1,
        "from": 1,
        "to": 1
    }
}
Описание полей ответа
  • notifications.id — идентификатор уведомления.
  • notifications.icon — иконка уведомления. Сейчас возвращается null.
  • notifications.title — заголовок уведомления.
  • notifications.status — код события, например subscription.charge_failed.
  • notifications.body — текст уведомления или null.
  • notifications.action_url — ссылка на связанное действие или null.
  • notifications.created_at — время создания в ISO 8601.
  • pagination — данные текущей страницы.

Если уведомлений нет, API вернёт пустой массив notifications и объект pagination с нулевым total.

Возможные ошибки

  • 401 — проверьте App Token и Bearer token.
  • 404 — проверьте проект; для application-scoped Bearer также проверьте Application.
  • 429 — превышен лимит 60 запросов в минуту. Повторите запрос после паузы.

© 2026 Gigma