API-токени та webhooks

Доступність

API та webhooks входять у тарифи, які їх містять (див. сторінку цін). Якщо у вашому тарифі їх немає, сторінка API і webhooks про це скаже. Відкрити її можуть лише власники й адміністратори.

Створіть токен

1. Відкрийте API і webhooks і знайдіть Токени.
2. Введіть Назву токена, наприклад «наша CRM». За замовчуванням токен лише читає. Позначте Може додавати сайти й запускати перевірки, якщо інструменту потрібен запис.
3. Натисніть Створити токен і одразу скопіюйте його: він показується лише раз. Якщо загубили, видаліть токен і створіть новий.

Видаляйте токени, якими більше не користуєтеся; у списку видно, коли кожен використовували востаннє.

Звертайтеся до API

Базову адресу й посилання на опис OpenAPI наведено в блоці Як почати. Передавайте токен у заголовку:

curl -H "Authorization: Bearer $TOKEN" -H "Accept: application/json" https://pandus.online/api/v1/sites

Через API можна переглядати сайти, додавати й видаляти їх, запускати перевірку, отримувати перевірку, її звіт і PDF. Токен може надсилати до 60 запитів на хвилину.

Webhooks

Webhook повідомляє вашу систему, коли щось відбулося, тож питати не потрібно. Натисніть Додати webhook, введіть https-адресу й оберіть події: завершення перевірки (scan.completed) і нові знайдені проблеми (issues.new). У команди може бути до п’яти адрес.

Кожне повідомлення підписане. У заголовку Pandus-Signature є час і підпис HMAC-SHA256, створений вашим Секретом підпису. Перевіряйте його, перш ніж довіряти повідомленню.

Кнопка Надіслати тест перевіряє адресу. Журнал доставки показує кожну спробу. Невдале повідомлення надсилається повторно до шести разів приблизно за добу; можна повторити й вручну. Адресу, що постійно збоїть, вимикають після 20 невдач поспіль. Адреси, що ведуть до приватної мережі, відхиляються.