API HookBin
REST API для автоматизации: создавайте endpoint'ы, читайте историю, настраивайте mock.
Webhook URL (/e/…) остаётся публичным — token нужен только для панели и API управления.
Быстрый старт
# 1. Создать endpoint
curl -X POST https://hookbin.ru/api/endpoints
# Ответ: id, webhookUrl, panelUrl (с ?token=…), expiresAt
# 2. Отправить webhook на webhookUrl
curl -X POST "https://hookbin.ru/e/ENDPOINT_ID" \
-H "Content-Type: application/json" -d '{"hello":true}'
# 3. Прочитать историю (нужен token из panelUrl или заголовок)
curl "https://hookbin.ru/api/endpoints/ENDPOINT_ID?token=ACCESS_TOKEN"
Авторизация endpoint
Доступ к GET/PATCH /api/endpoints/:id, replay, CSV и WebSocket панели:
- Query:
?token=ACCESS_TOKEN(изpanelUrlпри создании) - Header:
X-HookBin-Token: ACCESS_TOKEN - Сессия владельца (если endpoint привязан к аккаунту)
Без token API вернёт 404 (как для несуществующего id).
Аккаунт и API-ключ
# Регистрация / вход — cookie hookbin_session
POST /api/auth/register {"email","password","privacyConsent":true}
POST /api/auth/login {"email","password"}
# API-ключ (создаётся в /account)
GET /api/account/endpoints Header: X-API-Key: hb_…
POST /api/endpoints Header: X-API-Key: hb_…
Endpoint
| Метод | URL | Описание |
|---|---|---|
| POST | /api/endpoints | Создать endpoint |
| GET | /api/endpoints/:id | История + mock (token) |
| PATCH | /api/endpoints/:id | Mock, alertEmail, profiles |
| GET | /api/endpoints/:id/export.csv | CSV export |
| POST | /api/endpoints/:id/requests/:rid/replay | Replay запроса |
| ALL | /e/:id | Приём webhook (публично) |
| WS | /ws/:id?token=… | Live-панель |
Mock (PATCH)
curl -X PATCH "https://hookbin.ru/api/endpoints/ID?token=TOKEN" \
-H "Content-Type: application/json" \
-d '{
"mockEnabled": true,
"mockStatus": 200,
"mockBody": "{\"ok\":true}",
"mockContentType": "application/json",
"mockDelayMs": 0
}'
Лимиты
- Free: endpoint 7 дней, 25 запросов в истории, 2 endpoint'а в аккаунте
- Pro: 30 дней endpoint, 100 запросов, mock по path, email-алерты
- Body webhook: до 1 MB
- Rate limit: см. заголовки
X-RateLimit-*