Документация
comments/get

Возвращает комментарий.

Доступен для всех тарифных планов.
URL
http://c1api.hypercomments.com/1.0/comments/get
Проверка авторизации пользователя

Нет

Формат ответа

JSON, JSONP

Параметры запроса
Параметр Описание
обязательный
body
JSON строка с параметрами запроса.
обязательный
widget_id
int ID виджета для которого выполняется запрос
обязательный
link
string URL страницы, комментарии которой необходимо получить
обязательный
id
string ID комментария
xid string Идентификатор страницы, к которому привязаны комментарии
обязательный
signature
Подпись запроса. Правила формирования подписи.
callback Необязательный параметр, необходимый для кроссдоменных клиент-сервер запросов с использованием технологии JSONP. В значении параметра передается название callback функции в которую будет передан результат выполнения запроса
Параметры ответа
Параметр Описание
обязательный
result
Результат выполнения запроса
  • success - успешное выполнение запроса
  • error - ошибка выполнения запроса
обязательный
data
Массив объектов результата запроса
widget_id ID виджета
stream_id ID страницы
unixtime Время создания комментария в Unixtime
time Время создания комментария
id ID комментария
parent_id ID родительского комментария
root_id ID первого комментария ветки по отношению к текущему комментарию
text Текст комментария
files JSON строка с массивом медиа вложений
type Тип медиа вложения [images|video|presentation]
service Сервис через который отправлено медиа вложение
href Путь к ресурсу
id ID медиа вложения (для type = video)
preview Путь к картинке предварительного просмотра видео
parent JSON строка с информацией о родительском комментарии
time Время создания родительского комментария
text Текст родительского комментария
files медеа вложения комментария
parent_id ID родительского комментария
acc_id ID пользователя
t Флаг гиперкомментария
nick Имя пользователя
avatar Ссылка на аватар анонимного пользователя или пользователя SSO
nick Имя пользователя
email email анонимного пользователя (для сервиса Gravatar)
md5email md5 хэш от email анонимного пользователя (для сервиса Gravatar)
acc_id ID пользователя
ip IP адрес комментатора
vote_up Количество положительных голосов за комментарий
vote_dn Количество отрицательных голосов за комментарий
vote Суммарный рейтинг голосов за комментарий
children Количество дочерних комментариев
state Состояние комментария:
  • 1 - комментарий утвержден
  • 2 - комментарий в ожидании
  • 3 - комментарий помечен как спам
  • 4 - комментарий удален
topic Флаг выделенного фрагмента текста
param Координаты фрагмента текста
hc_comment Флаг true - гиперкомментарий; false - комментарий
avatar Ссылка на аватар анонимного пользователя или пользователя SSO. Для остальных путь к аватару определяется как
https://static.hypercomments.com/data/avatars/{acc_id}/avatar
category ID категории комментария
href URL страницы, без http(https) и www
complain_count Количество жалоб на комментарий
spam_user_count Количество пометок спам за комментарий
page_title Название страницы
complain_moderate Флаг обработки жалобы
reason_del Причина удаление комментария
spam_service Спам сервис через который комментарий был определен как спам
quote_id ID цитаты к которой привязан комментарий
Пример ответа
{
  "result" : "success",
  "data" : [
    {
      "widget_id" : 9697,
      "stream_id" : "54465f98e198637a4d000002",
      "unixtime" : 1417707719.168013,
      "time" : "Thu, 04 Dec 2014 11:16:27 GMT",
      "id" : "1417691787280674",
      "parent_id" : "1417691787280672",
      "root_id" : "1417691787280670",
      "text" : "Comment Text",
      "files" : "[
        {
          \"type\" : \"images\",
          \"service\" : \"internet\",
          \"href\" : \"http://path.to/image\"
        },
        {
          \"type\" : \"video\",
          \"service\" : \"youtube\",
          \"href\" : \"https:\/\/www.youtube.com\/watch?v=Zelg\",
          \"id\" : \"Zelg"\,
          \"preview"\ : \"http:\/\/img.youtube.com\/vi\/Zelg\/1.jpg\"
        },
        {
          \"type\" : \"presentation\",
          \"service\" : \"google\",
          \"href\" : \"https://docs.google.com\/presentation/embed?id=1r9H-lUALqGfEDDQtBub7AzVSjrc3zmVi\"
        }
      ]",
      "parent" : "{
         \"time\" : \"Thu, 04 Dec 2014 10:23:13 GMT\",
         \"text\" : \"Parent text comment\",
         \"files\" : null,
         \"parent_id\" : null,
         \"acc_id\" : 455517,
         \"t\" : false,
         \"nick\" : \"nick\",
         \"avatar\" : \"http:\/\/path.to\/avatar\",
         \"category\" : null
       }",
      "nick" : "Test Nick",
      "email" : null,
      "md5email" : null,
      "acc_id" : 1,
      "ip" : "176.34.176.235",
      "vote_up" : 3,
      "vote_dn" : 4,
      "vote" : -1,
      "children" : 3,
      "state" : 1,
      "topic" : false,
      "param" : null,
      "hc_comment" : false,
      "avatar" : "http://path.to/avatar",
      "category" : null,
      "href" : "http://test.com/page1",
      "title" : "Title page",
      "complain_count" : 3,
      "spam_user_count" : 5,
      "page_title" : "Page title",
      "complain_moderate" : false,
      "reason_del" : null,
      "spam_service" : null,
      "quote_id" : null
    }
  ]
}