- 무료
- 회원가입 불필요
- 24시간 후 만료
Webhook / 콜백 테스터
임시 URL을 받아 콜백을 연결하고 수신된 본문과 보존된 헤더를 검사합니다. HiAPI 비동기 작업 콜백 디버깅용으로 제작되었습니다. 64 KiB 초과 POST 본문은 413을 반환하며 저장되거나 잘리지 않습니다. 쿠키, 전달/클라이언트 IP 및 인그레스 시크릿 헤더는 보존되지 않습니다.
이 URL을 가진 사람은 누구나 여기에 도착하는 내용을 읽을 수 있으며 만료 시 모두 삭제됩니다. 프로덕션 트래픽이나 민감한 데이터에 사용하지 마세요.
이 브라우저에서 샘플 페이로드를 주소로 전송하여 실제 콜백을 연결하기 전에 도구 작동을 확인할 수 있습니다.
발신자가 받는 응답
이것을 변경하여 재시도를 테스트하세요: 비-2xx 상태를 반환하면 HiAPI가 콜백을 재시도하므로 목록에서 일정을 확인할 수 있습니다.
요청
첫 번째 요청을 기다리는 중…
위 URL로 콜백을 연결하거나 테스트 요청을 보내 어떻게 보이는지 확인하세요.
요청 상세
요청을 선택하여 헤더와 본문을 확인하세요.
이 콜백으로 작업 생성
이것을 복사하고 키와 모델을 교체한 후 실행하세요.
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.url로 전달하거나 「테스트 요청 보내기」 버튼을 사용하여 즉시 전송하세요.
요청 읽기
요청이 도착하는 대로 표시됩니다. 헤더, 본문, 콘텐츠 유형을 검사하고 Webhook 서명 키를 붙여넣어 로컬에서 서명을 확인하세요.
What this tool cannot do
- HiAPI HMAC 일관성만 비교하며 신선도나 재생 방지는 검증하지 않습니다. 일치만으로는 출처를 증명할 수 없습니다. 서명 키가 없으면 콜백은 다른 POST와 같습니다.
- 64 KiB 초과 본문은 413을 반환하며 저장되거나 잘리지 않습니다. 쿠키, 전달/클라이언트 IP 및 인그레스 시크릿 헤더는 보존되지 않습니다.
- 재생은 정확한 원본 요청이 아닙니다. 헤더가 제거되고 CORS, 혼합 콘텐츠 또는 로컬 네트워크 규칙이 차단할 수 있습니다. localhost 접근은 보장되지 않습니다.
- 작업을 조회할 수 없습니다. 페이로드만 수신하므로 작업 상태, 잔액 또는 아티팩트에 접근할 수 없습니다.
- 영구 저장소가 아닙니다. 주소와 그 내용은 24시간 후에 삭제되므로 프로덕션 또는 민감한 데이터를 보내지 마세요.
- URL이 자격 증명입니다. URL을 가진 사람은 누구나 도착하는 내용을 읽을 수 있습니다.
- HiAPI가 공개 인터넷을 통해 접근해야 하므로 localhost 대상은 실제 HiAPI 콜백을 받을 수 없습니다.
Webhook tester FAQ
Webhook 테스터의 용도는?
Webhook 테스터는 수신 HTTP 요청을 수락하고 보존된 헤더와 본문을 표시하는 주소를 제공합니다. 쿠키, 전달/클라이언트 IP 및 인그레스 시크릿 헤더는 삭제됩니다. 64 KiB 초과 본문은 413을 반환하며 저장되거나 잘리지 않습니다. 콜백을 검사하기 위해 서버를 따로 설정할 필요가 없습니다.
HiAPI 콜백을 테스트하려면?
HiAPI API에서 작업을 생성하고 이 페이지의 URL을 callback.url로 전달하세요. 작업이 종료 상태에 도달하면 HiAPI가 결과를 여기에 POST하고 요청이 목록에 표시됩니다.
로컬에서 HiAPI로 테스트할 때 콜백이 도착하지 않는 이유는?
콜백은 공개 인터넷에서 접근 가능해야 합니다. 귀하의 기기는 일반적으로 그렇지 않으므로 localhost 주소는 실제 HiAPI 콜백을 받을 수 없습니다. 공개 호스트의 URL을 사용하세요. 이 페이지가 제공합니다.
콜백이 실제로 HiAPI에서 왔는지 확인할 수 있나요?
Webhook 서명 키를 사용하면 이 도구는 보존된 본문과 X-HiAPI-Timestamp로 HMAC-SHA256을 재계산하고 X-HiAPI-Signature를 로컬에서 비교합니다. 일치는 해당 키와의 일관성을 보여주며 신선도나 재생 방지를 의미하지 않습니다. 서명 키가 없으면 비교할 서명이 없습니다.
제 Webhook 서명 키가 서버로 전송되나요?
아니요. 키는 브라우저의 Crypto API 내에서만 서명 재계산에 사용됩니다. 전송, 저장 또는 기록되지 않으며 서버에 도달하는 요청에도 포함되지 않습니다.
주소의 유효 기간과 데이터 처리는?
주소와 수신된 모든 내용은 24시간 후에 삭제됩니다. 각 주소는 최대 50개의 요청을 보관합니다. URL을 자격 증명으로 취급하세요. URL을 가진 사람은 누구나 도착한 내용을 읽을 수 있으므로 프로덕션 또는 민감한 데이터에 사용하지 마세요.
HiAPI가 실패한 콜백을 얼마나 자주 재시도하는지 알 수 있나요?
네, 그래서 응답 상태를 설정할 수 있습니다. 응답을 400 또는 500으로 설정하고 실제 작업을 트리거하면 목록의 도착 시간이 재시도 일정을 보여줍니다. 재시도는 즉시, 그 다음 +1분, +5분, +20분에 발생하며 총 4회 시도합니다.
요청을 재생할 수 있나요?
재생은 브라우저에서의 최선형 요청으로 정확한 복사본이 아닙니다. 쿠키, 인증, 프록시/플랫폼 및 브라우저 제어 헤더는 전달되지 않으며 리디렉션은 거부됩니다. 대상이 CORS를 허용해야 합니다. HTTPS에서 HTTP로의 혼합 콘텐츠 및 브라우저 로컬 네트워크 규칙이 차단할 수 있습니다. localhost는 작동할 수 있지만 보장되지 않습니다. 차단된 응답이 대상이 아무것도 수신하지 않았음을 증명하지는 않습니다.