- Бесплатно
- Без регистрации
- Истекает через 24 ч
Тестер Webhook / Callback
Получите временный URL, направьте на него callback и проверяйте полученные тела и сохранённые заголовки. Создан для отладки callback-ов асинхронных задач HiAPI. Тела POST более 64 КиБ возвращают 413 и никогда не сохраняются и не обрезаются; cookie, заголовки переадресованного/клиентского IP и секрета входа не сохраняются.
Любой, у кого есть этот URL, может прочитать то, что сюда приходит, и всё удаляется по истечении срока. Не используйте для продакшен-трафика или конфиденциальных данных.
Отправляет пример данных на ваш адрес из этого браузера, чтобы вы могли увидеть работу инструмента до настройки реального callback.
Ответ, который получает отправитель
Измените это для тестирования повторов: верните не-2xx статус, и HiAPI повторит callback, чтобы вы могли наблюдать расписание в списке.
Запросы
Ожидание первого запроса…
Направьте callback на URL выше или отправьте тестовый запрос, чтобы увидеть, как это выглядит.
Детали запроса
Выберите запрос, чтобы увидеть его заголовки и тело.
Создать задачу с этим callback
Скопируйте это, замените ключ и модель и запустите.
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1.0",
"callback": { "url": "https://www.hiapi.ai/tools/webhook-tester/hook/YOUR_TOKEN", "when": "final" },
"input": { "prompt": "a cyan glass data center entrance", "duration": 5, "resolution": "720p" }
}'How to test a webhook in three steps
Скопируйте временный URL
Откройте эту страницу и скопируйте адрес, который она даёт. Он активен 24 часа и принимает POST из любого источника.
Направьте callback на него
Передайте как callback.url при создании асинхронной задачи или используйте кнопку «Отправить тестовый запрос», чтобы запустить сразу.
Прочитайте запрос
Запросы появляются по мере поступления. Проверяйте заголовки, тело и тип контента; вставьте ключ подписи webhook для локальной проверки подписи.
What this tool cannot do
- Сравнивается только согласованность HMAC HiAPI, но не свежесть и не защита от повтора, и одно лишь совпадение не может доказать происхождение. Без ключа подписи callback выглядит как любой другой POST.
- Тела более 64 КиБ возвращают 413 и никогда не сохраняются и не обрезаются. Cookie, заголовки переадресованного/клиентского IP и секрета входа не сохраняются.
- Повтор — не точная копия исходного запроса. Заголовки удаляются, а правила CORS, смешанного контента или локальной сети могут его заблокировать; доступ к localhost не гарантируется.
- Не может искать задачи. Он только получает полезные данные, поэтому не имеет доступа к статусу задачи, балансу или артефактам.
- Это не постоянное хранилище. Адрес и его содержимое уничтожаются через 24 часа, поэтому не отправляйте производственные или конфиденциальные данные.
- URL — это учётные данные. Любой, у кого он есть, может прочитать то, что приходит.
- Цель localhost никогда не получит реальный callback HiAPI, потому что HiAPI должен достичь её через публичный интернет.
Webhook tester FAQ
Для чего нужен тестер webhook?
Тестер webhook даёт вам адрес, принимающий входящие HTTP-запросы и показывающий сохранённые заголовки и тело. Cookie, заголовки переадресованного/клиентского IP и секрета входа отбрасываются. Тела более 64 КиБ возвращают 413 и никогда не сохраняются и не обрезаются. Избавляет от необходимости поднимать сервер только для проверки callback.
Как протестировать callback HiAPI?
Создайте задачу в API HiAPI и передайте URL этой страницы как callback.url. Когда задача достигнет конечного состояния, HiAPI отправит результат сюда POST-запросом, и запрос появится в списке.
Почему callback не приходит при локальном тестировании с HiAPI?
Callback должен быть доступен из публичного интернета. Ваша машина обычно таковой не является, поэтому адрес localhost никогда не получит реальный callback HiAPI. Используйте URL на публичном хосте — эта страница предоставляет его.
Можно ли проверить, что callback действительно пришёл от HiAPI?
С ключом подписи webhook этот инструмент пересчитывает HMAC-SHA256 по сохранённому телу и X-HiAPI-Timestamp и сравнивает X-HiAPI-Signature локально. Совпадение показывает согласованность с этим ключом, но не свежесть и не защиту от повтора. Без ключа подписи нечего сравнивать.
Отправляется ли мой ключ подписи webhook на ваш сервер?
Нет. Ключ используется только в Crypto API вашего браузера для пересчёта подписи. Он никогда не передаётся, не сохраняется и не логируется, и запрос, достигающий нашего сервера, не содержит его.
Как долго живёт адрес и что происходит с данными?
Адрес и всё, что он получил, удаляются через 24 часа. Каждый адрес хранит до 50 запросов. Относитесь к URL как к учётным данным: любой, у кого он есть, может прочитать поступившее, поэтому не используйте его для продакшена или конфиденциальных данных.
Может ли он сказать, как часто HiAPI повторяет неудачный callback?
Да, именно поэтому статус ответа настраивается. Установите ответ 400 или 500, запустите реальную задачу, и время поступления в списке покажет расписание повторов. Повторы происходят немедленно, затем через +1, +5 и +20 минут, всего четыре попытки.
Можно ли повторить запрос?
Повтор делает запрос из браузера по принципу best-effort, а не точную копию. Cookie, авторизация, заголовки прокси/платформы и управляемые браузером не пересылаются, а перенаправления отклоняются. Цель должна разрешать CORS; смешанный контент HTTPS-HTTP и правила локальной сети браузера могут блокировать запросы, включая localhost. Ошибка браузера не означает, что цель ничего не получила.