comments/create
Создает комментарий на странице.
Доступен для тарифных планов, которые поддерживают SSO авторизацию.
URL
http://c1api.hypercomments.com/1.0/comments/create
Проверка авторизации пользователя
Да
Формат ответа
JSON, JSONP
Параметры запроса
| Параметр |
Описание |
обязательный
body
|
JSON строка с параметрами запроса.
обязательный
widget_id
|
int |
ID виджета для которого выполняется запрос |
обязательный
link
|
string |
URL страницы, комментарии которой необходимо получить |
обязательный
title
|
string |
Название страницы с комментарием |
обязательный
text
|
string |
Текст комментария
|
обязательный
auth
|
string |
Строка авторизации пользователя, который отправляет комментарий
Правило формирования строки авторизации.
|
parent_id
|
string |
ID родительского комментария |
xid
|
string |
Идентификатор страницы, к которому привязаны комментарии |
|
обязательный
signature
|
Подпись запроса. Правила формирования подписи |
callback |
Необязательный параметр, необходимый для кроссдоменных клиент-сервер запросов
с использованием технологии JSONP. В значении параметра передается название callback функции
в которую будет передан результат выполнения запроса
|
Параметры ответа
| Параметр |
Описание |
обязательный
result
|
Результат выполнения запроса
success - успешное выполнение запросаerror - ошибка выполнения запроса
|
обязательный
data
|
Объект результата запроса
ip
|
IP адрес комментатора |
widget_id
|
ID виджета |
stream_id
|
ID страницы |
parent_id
|
ID родительского комментария |
root_id
|
ID первого комментария ветки по отношению к текущему комментарию |
text
|
Текст комментария
|
files
|
JSON строка с массивом медиа вложений
type |
Тип медиа вложения [images|video|presentation] |
service |
Сервис через который отправлено медиа вложение |
href |
Путь к ресурсу |
id |
ID медиа вложения (для type = video) |
preview |
Путь к картинке предварительного просмотра видео |
|
link
|
URL страницы, без http(https) и www |
title
|
Название страницы
|
acc_id
|
ID пользователя |
id
|
ID комментария |
nick
|
Имя пользователя |
unixtime
|
Время создания комментария в Unixtime |
time
|
Время создания комментария |
parent
|
JSON строка с информацией о родительском комментарии
time |
Время создания родительского комментария |
text |
Текст родительского комментария |
files |
медиа вложения комментария |
parent_id |
ID родительского комментария |
acc_id |
ID пользователя |
t |
Флаг гиперкомментария |
nick |
Имя пользователя |
avatar |
Ссылка на аватар анонимного пользователя или пользователя SSO |
|
avatar
|
Ссылка на аватар анонимного пользователя или пользователя SSO.
Для остальных путь к аватару определяется как
https://static.hypercomments.com/data/avatars/{acc_id}/avatar
|
md5email
|
md5 хэш от email анонимного пользователя (для сервиса Gravatar) |
user_id
|
ID пользователя в Вашей системе |
hc_comment
|
Флаг true - гиперкомментарий; false - комментарий |
state
|
Состояние комментария:
- 1 - комментарий утвержден
- 2 - комментарий в ожидании
- 3 - комментарий помечен как спам
- 4 - комментарий удален
|
spam_service
|
Спам сервис через который комментарий был определен как спам |
|
Пример ответа
{
"result" : "success",
"data" :
{
"ip" : "176.34.176.235",
"widget_id" : 9697,
"stream_id" : "54465f98e198637a4d000002",
"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\"
}
]",
"link" : "http://test.com/page1",
"title" : "Title page",
"acc_id" : 1,
"id" : "1417691787280674",
"nick" : "Test Nick",
"unixtime" : 1417707719.168013,
"time" : "Thu, 04 Dec 2014 11:16:27 GMT",
"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
}",
"avatar" : "http://path.to/avatar",
"md5email" : null,
"user_id" : "10",
"hc_comment" : false,
"state" : 1,
"spam_service" : null
}
}