Надіслати події у вашу власну систему за допомогою вебхуків

Webhook дозволяє IDup викликати Вашу веб-адресу в момент, коли щось відбувається, наприклад, коли рахунок оплачено. Кожна доставка підписується і повторюється, якщо Ваша система не відповідає.

Додати кінцеву точку

1. Відкрити Вебхуки вкладка і натисніть Додати кінцеву точку.
2. Введіть Ім'я і URL. Вона повинна бути публічно доступною. Адреси всередині приватної мережі відхиляються з міркувань безпеки.
3. Позначте Події Ви хочете.
4. Необов'язково: оберіть Ключ API. Кінцева точка отримує лише події, які цей ключ може читати.
5. Натисніть Зберегти. IDup показує Ваш секрет підпису один раз. Зберігайте його безпечно.

Події

• Рахунок-фактура створено, Рахунок-фактура оплачено, Платіж отримано
• Новий клієнт, Новий контакт, Новий потенційний клієнт, Новий квиток
• Пропозиція прийнята — пропозиція, яку прийняв клієнт

Кожна доставка має три заголовки: назву події, номер доставки та підпис. Повторна спроба зберігає той самий номер доставки, щоб ваша система могла розпізнати дублікати.

Перевірити підпис

Ваша система повинна обчислити HMAC-SHA256 за часом і сирим тілом з Вашим секретом, порівняти його з підписом і відхилити час, старший за 5 хвилин. Натисніть Перевірити підпис та приклади для готового коду.

Тест, пауза та поновлення

• Надіслати тест надсилає тестову подію та показує код HTTP і час, який це зайняло.
• Пауза зупиняє доставки; Активувати запускає їх знову.
• Секретний код створює новий секрет. Старий перестає працювати одразу.
• Видалити видаляє кінцеву точку. Її журнал зберігається.

Повторні спроби та журнал

Ваша адреса повинна відповідати кодом 2xx протягом 5 секунд. Перенаправлення не слідуються. Якщо це не вдається, IDup спробує знову через 1 хвилину, 5 хвилин, 30 хвилин, 2 години та 12 годин. Після шостої спроби доставка позначається Здався.

Журнал показує кожну спробу з подією, кінцевою точкою, спробою, HTTP кодом, тривалістю та початком відповіді. Статус Очікування, Доставлено, Не вдалося або Здався. Використовуйте Відправити повторно щоб відправити доставку знову.