Получить события пользователя

Этот метод позволяет получить события, которые совершил пользователь, в хронологическом порядке (начиная от самых новых к самым старым).

URL

GET https://api.carrotquest.io/v1/users/{id}/events

В качестве {id} можно использовать:

  • ID из нашей системы
  • Ваш User ID (если пользователя с таким идентификатором не существует, будет возвращена ошибка)

Аргументы

Этот метод следует общим правилам. Аргументы передаются как GET или POST параметры.

Аргумент Описание
auth_token Обязательный. Токен авторизации (нужен scope: user-read)
filter_name Если указать здесь название события, будут возвращены только события этого типа
after Пагинация, начать с данного курсора
count Пагинация, максимальное количество диалогов, которое нужно вернуть (от 1 до 50). По умолчанию: 20

Подробнее о пагинации.

Ответ

{
  "meta": {
    "next_after": 335695472,
    "status": 200
  },
  "data": [
    {
      "id": 335704586,
      "created": 1467192929,
      "type": {
        "id": 5857,
        "name": "MyEvent",
        "score": 0,
        "visible": true
      },
      "user": 22735768,
      "props": {
        "App": "Eva99"
      }
    },
    ...
  ]
}

Ответ будет содержать объекты Event.

Примеры

Получить все события пользователя:

curl -X GET https://api.carrotquest.io/v1/users/8173131/events?auth_token=XXX

Получить только события типа MyEventOne:

curl -X GET https://api.carrotquest.io/v1/users/8173131/events?auth_token=XXX&filter_name=MyEventOne