Перейти до основного вмісту

​
Що таке Webhook?

Webhook дозволяє отримувати сповіщення, коли відбуваються певні дії системи, через виклик URL, який Ви надаєте. Webhook також відомі як “URL Callbacks” або “HTTP push calls”. Ваш URL повинен використовувати SSL і починатися з HTTPS.

Дії Webhook

Перегляньте доступні дії для webhook.

​
Розуміння Webhook Ayrshare

Webhook класифіковані за конкретною дією і реєструються на рівні Primary Profile або User Profile. Будь-які оновлення для Primary або User Profiles спочатку надсилаються до зареєстрованого Webhook для User Profile. Якщо User Profile не має зареєстрованого Webhook, оновлення буде надіслано до зареєстрованого Webhook Primary Profile. Наприклад:
  • Якщо User Profile має зареєстрований Social Action Webhook і від’єднує TikTok, буде викликано зареєстрований URL Social Action Webhook для User Profile. Webhook Primary Profile не буде викликано.
  • Якщо User Profile від’єднує TikTok і не має зареєстрованого Social Action Webhook, але Primary Profile має зареєстрований Webhook, буде викликано зареєстрований URL Social Action Webhook для Primary Profile.

​
Реєстрація Webhook

Зареєструйте Webhook, надавши URL кінцевої точки та тип дії до кінцевої точки POST /hook/webhook. Коли дія відбувається, до наданого URL надсилається повідомлення HTTP POST. Наприклад, зареєструйте URL для отримання сповіщень про статус запланованого допису. URL кінцевої точки Webhook не повинен використовувати перенаправлення і має бути кінцевим URL призначення. Якщо Ви зареєструєте лише webhook Primary Profile, User Profiles автоматично успадкують webhook Primary Profile. Щоб мати унікальний webhook для кожного User Profile, Ви повинні зареєструвати webhook для кожного User Profile.
Після отримання Вашим Webhook HTTP POST, Ваш сервер повинен відповісти HTTP-статусом 200, щоб позначити виклик як успішний. Якщо Ваш сервер не відповість протягом 10 секунд, буде зареєстровано відповідь 503.
Ви також можете зареєструвати webhook у Developer Dashboard.

​
Повторні спроби Webhook

Якщо HTTP-відповідь Вашого сервера не в діапазоні успіху 200-299, система автоматично повторить виклик Webhook ще двічі. Перша повторна спроба буде через 5 секунд, а друга — через 30 секунд. Повторні спроби матимуть той самий hookId і будуть позначені як спроби повторення.

​
Безпека Webhook

Ви можете додати додаткову безпеку, встановивши автентифікацію HMAC як HTTP-запит. Це часто робиться для запобігання атакам відтворення. Ayrshare використовує HMAC-SHA256 для хешування тіла повідомлення та включає його разом із UNIX timestamp у заголовок POST.
На основі секретного ключа, встановленого при реєстрації Вашого webhook, Ви можете валідувати POST, порівнявши заголовок X-Authorization-Content-SHA256 з хешем SHA256 тіла POST. Секретний ключ використовується для всіх дій webhook, тому встановлення його для однієї дії змінить секрет для всіх дій.

​
Журнали Webhook

У Панелі керування Ayrshare Ви можете переглядати активні webhook, бачити деталі надісланого Webhook, статус відповіді Вашого сервера та повторно надсилати Webhook на зареєстрований URL. Переключіться на конкретний User Profile, щоб переглядати журнали Webhook цього профілю.

​
Коди відповідей HTTP

Перший стовпець показує успішну HTTP-відповідь ✔️ (200, 300) від Webhook або невдалу відповідь ✖️ (400, 500). Переключіться на конкретний user profile, щоб переглядати журнали Webhook цього профілю.

​
Відсоток помилок

“Error Rate” з останніх 1 000 дописів можна переглянути на сторінках Actions та Webhook Logs у панелі керування. Будь-яка відповідь webhook від Вашого сервера з кодом 400-500 вважається помилкою.