Получить части диалога

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

URL

GET https://api.carrotquest.io/v1/conversations/{id}/parts

В качестве {id} нужно использовать ID диалога.

Аргументы

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

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

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

Ответ

{
  "data": [
    {
      "id": 7936880,
      "created": 1450420434,
      "conversation": 7179725,
      "body": "...",
      "read": true,
      "type": "reply_admin",
      "sent_via": "app_chrome",
      "from": {
        "id": 14709,
        "name": "Alex",
        "avatar": "https://files.carrotquest.io/avatars/1422020258978-15jb56g7.jpg",
        "type": "admin"
      }
    },
    ...
  ],
  "meta": {
    "next_after": 7936756,
    "status": 200
  }
}

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

Ошибки

Эта таблица содержит ошибки, которые могут быть возвращены. Однако, в случае непредвиденных ситуаций ввиду неработоспособности сервиса могут возникнуть другие ошибки. Всегда следует проверять параметр meta.status.

Ошибка Описание
MethodNotAllowed Неверный HTTP-метод
AuthenticationFailed Токен авторизации неверен (или отсутствует)
PermissionDenied Нет доступа к этому диалогу (скорее всего, диалог принадлежит другому приложению)

Примеры

curl -X GET https://api.carrotquest.io/v1/conversations/313341/parts?auth_token=XXX