Получение информации о комментарии

Метод Get note используется для получения информации о комментарии к сущности платформы.

Для авторизации требуется API-токен менеджера (сотрудника). API-токен можно получить через Панель управления Оператора (см. Просмотр и обновление информации о сотруднике).

По указанному в запросе API-токену определяются:

  • Роль и уровень доступа менеджера, от которых зависит доступность метода.
  • Текущий реселлер и его нижестоящие реселлеры, доступные в рамках метода.

GET {base_url}/api/v3/resellers/{reseller_id}/notes/{note_id}

Аргументы

Название

Тип параметра

Тип данных

Обязательный/ 
Опциональный

Описание

X-Api-TokenheaderstringОбязательныйAPI-токен сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-TypeheaderstringОбязательныйТип данных, передаваемых в запросе. Необходимо указать: application/vnd.api+json
AcceptheaderstringОбязательныйПоддерживаемые типы данных в ответе. Необходимо указать: application/vnd.api+json
base_urlpathstringОбязательныйURL ActivePlatform
reseller_idpathintegerОбязательныйID реселлера. Возможно указать ID текущего реселлера или ID любого из его нижестоящих реселлеров (см. Просмотр информации о реселлере)
note_idpathintegerОбязательныйID комментария

Модель ответа

Название

Тип данных

Описание

dataobjectДанные ответа


id

string

ID комментария

typestringТип данных

attributesobjectИнформация о комментарии


created_at

string

Дата и время создания комментария


updated_atstringДата и время последнего изменения комментария


contentstringТекст комментария


creatorstring

Информация о том, кто добавил комментарий:

  • Имя менеджера, добавившего комментарий.
  • Системный — комментарий был добавлен автоматически.


original_linkstringСсылка на комментарий


original_idintegerID сущности в платформе, к которой относится комментарий. Для комментариев, которые относятся к сущности Клиент, original_id = null


original_typestringТип сущности в платформе, к которой относится комментарий. Возможные значения:
  • null — Клиент.
  • Subscription — Подписка.
  • Order — Заказ.
  • ManualOperation — Ручная операция.
  • Discount — Скидка.


attachmentobjectИнформация о файле, прикрепленном к комментарию. Если файла нет, attachment = null



namestringНазвание файла



urlstringСсылка на файл



sizestringРазмер файла в байтах

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

GET /api/v3/resellers/1/notes/5
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

Пример ответа

{
    "data": {
        "id": "5",
        "type": "notes",
        "attributes": {
            "created_at": "2023-03-27T11:35:12.509+03:00",
            "updated_at": "2023-03-27T11:35:12.509+03:00",
            "content": "Migrated",
            "creator": "Bill Smith",
            "original_link": "/admin/accounts/29/notes/5",
            "original_id": null,
            "original_type": null,
            "attachment": {
                "name": "Logo",
                "url": "https://storage.test.activeplatform.com/private/uploads/note/attachment/5/Logo?expires=1680009898&hash=DStusb6w",
                "size": 3439
            }
        }
    }
}