Документация
Синхронизация комментариев

Система HyperComments позволяет осуществить синхронизацию комментариев с Вашим сайтом. Это означает, что все комментарии оставленные через систему HyperComments Вашими пользователями будут сохранятся у Вас в Базе Данных.

Для синхронизации комментариев необходимо:

  1. В административном разделе сайта в разделе "Настройки" -> "Настройка API" ввести "Секретный ключ" (Для пользователей Wordpress секретный ключ генерируется автоматически при активации плагина и редактировать его нельзя).
  2. Ввести в поле Notify URL URL-адрес, куда система HyperComments будет слать пакеты данных о событиях возникших в системе
  3. Поставить галочки напротив тех событий, которые хотите чтобы приходили к Вам на обработку

Пакеты данных отправляются по HTTP и HTTPS протоколам методом POST на указанный Notify URL.

Параметр Значение Описание
data Строка Массив событий в формате JSON. Например:
[{"cmd":"streamRemoveMessage","stream_id":"4fead3466bf6ab60f8000019", "widget_id":2, "id":"1367864629082801"}]
        
time int unixtime время отправки пакета данных
signature Строка Cигнатура (цифровая подпись пакета данных). Сигнатура формируется как md5 хэш от склеенной строки "Секретный ключ"+"Параметр data"+"Время":
md5(SECRETKEY+data+time)
Пример на формирования сигнатуры на PHP:
$signature = md5($secret_key.$data.$time))
Описание пакетов данных data

Опубликовано новое сообщение:

Параметр Значение Описание
cmd string Название пакета данных streamMessage
stream_id string ID страницы
widget_id int ID виджета
text string Текст комментария
acc_id int ID комментатора в системе HyperComments
nick string ник комментатора
email string почта комментатора
id string ID сообщения
parent_id string ID родительского сообщения
root_id string ID сообщения корня ветки
files string Прикрепленные файлы в формате JSON
ip string ip комментатора
user_id string ID пользователя в Вашей системе (при SSO)
parent_user_id string ID пользователя родительского сообщения в Вашей системе (при SSO)
category int Категория комментария
link string url страницы, где был оставлен комментарий
xid string идентификатор страницы, если был передан параметр xid в коде вставки виджета

Сообщение отредактировано:

Параметр Значение Описание
cmd string Название пакета данных streamEditMessage
stream_id string ID страницы
widget_id int ID виджета
id string ID сообщения
text string Текст комментария
link string url страницы, где был оставлен комментарий
xid string идентификатор страницы, если был передан параметр xid в коде вставки виджета

Сообщение удалено:

Параметр Значение Описание
cmd string Название пакета данных streamRemoveMessage
stream_id string ID страницы
widget_id int ID виджета
id string ID сообщения
link string url страницы, где был оставлен комментарий
xid string идентификатор страницы, если был передан параметр xid в коде вставки виджета