POST
/api/v1/webhooks웹훅 만들기
작업 및 문서 이벤트를 위한 서명된 콜백 대상을 등록합니다.
인증
API 키
범위
webhooks:write
계약
API v1
요청
curl -X POST 'https://api.maxscanner.app/api/v1/webhooks' \
-H 'Authorization: Bearer $MAXSCANNER_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: unique-request-id' \
-d '{ "url": "https://example.com/maxscanner/webhook", "events": ["job.completed"] }'요청 본문
{ "url": "https://example.com/maxscanner/webhook", "events": ["job.completed"] }응답
{ "id": "wh_123", "status": "active" }구현 참고 사항
- HTTPS 엔드포인트만 지원합니다.
- 서명을 검증하고 이벤트 ID 중복을 제거하세요.
이 엔드포인트 사용해 보기
엔드포인트를 애플리케이션에 연결하기 전에 API 플레이그라운드에서 인증하고 안전하게 테스트하세요.
플레이그라운드 열기 →