|
Help > Forum > Интеграция веб-сайтов > Использование веб-крючков Использование веб-крючковИспользуйте webhooks, чтобы получать уведомления о событиях, которые происходят на вашем форуме. Когда происходит событие - например, когда новый пользователь создает учетную запись на вашем форуме - Website Toolbox создает объект Event. Этот объект содержит всю необходимую информацию о том, что произошло, включая тип события и данные, связанные с этим событием. Затем мы отправляем объект Event как JSON на ваш URL webhook через HTTP-запрос POST. Веб-крюки отлично работают в сочетании с API форума. Например, webhook может уведомить ваше приложение, когда новый пользователь подписывается на ваш форум, а затем вы можете использовать API для внесения изменений в учетную запись форума этого пользователя. В настоящее время поддерживаются следующие события: user.created, user.утвержденного, user.updated, user.deleted, user.email.verified, user.payment.полученных, user.paid_subscription.запущен, user.paid_subscription.ended, topic.created, topic.updated, topic.deleted, post.created, post.утвержденного, post.updated, post.deleted, разговора.created и message.created. Пожалуйста дайте нам знать если вам нужно определенное новое событие webhook. Настройка настроек webhook
Ответ на webhook Чтобы подтвердить получение webhook, ваша конечная точка должна вернуть код состояния 2xx HTTP. Любая другая информация, возвращаемая в заголовках запроса или теле запроса, игнорируется. Все коды ответов за пределами этого диапазона, включая коды 3xx, будут указывать на то, что вы не получили webhook. Это означает, что перенаправление URL-адреса или ответ «Not Modified» будет рассматриваться как сбой. Если webhook не был успешно получен по какой-либо причине, мы будем продолжать пытаться отправить webhook один раз в час на срок до 3 дней. Пример события
{
"api_version": "1",
"data": {
"object": {
"signature": "Thanks, John.",
"name": "John Doe",
"allowEmails": false,
"lastPostTimestamp": 0,
"userGroups": [7440, 2452, 52423],
"userTitle": "Power User",
"reputation": 423,
"username": "john",
"postCount": 32,
"userId": 181855,
"lastVisitTimestamp": 1322811119,
"instantMessagingType": "",
"instantMessagingId": "",
"object": "User",
"invisible": false,
"email": "johnDoe@gmail.com",
"avatarUrl": "https://test.com/images/avatar.png",
"joinDateTimestamp": 1322811119,
"enableMessages": true
}
},
"object": "event",
"id": 1534,
"type": "user.created",
"mode": "live"
}
Просмотр событий и ответов webhook Вы можете просмотреть события, которые были отправлены на ваш webhook, и ответ, полученный от вашего webhook, следуя инструкциям ниже:
|