메인 콘텐츠로 건너뛰기
POST
웹훅 생성 (v3)

인증

Authorization
string
header
필수

외부 클라이언트 접근을 위한 Bearer API 키. 일반 키는 sk_ 접두사를 사용하고, 테스트 키는 sk_test_ 접두사로 모의 응답을 사용해 실제 처리나 크레딧 사용 없이 주문 흐름을 검증합니다.

본문

application/json
url
string<uri>
필수

웹훅 엔드포인트 URL

예시:

"https://example.com/webhook"

subscribedEvents
enum<string>[]
필수

필수이며 비어 있거나 중복된 이벤트는 허용하지 않습니다.

Minimum array length: 1
사용 가능한 옵션:
order.antiAi.completed,
order.antiAi.failed,
order.watermarkEmbed.completed,
order.watermarkEmbed.failed,
order.watermarkExtract.completed,
order.watermarkExtract.failed,
order.aiDetection.completed,
order.aiDetection.failed
name
string

웹훅 이름 (식별용)

Maximum string length: 100
isTest
boolean

엔드포인트 모드. 테스트 API 키에서는 생략하거나 true를 사용하며 false는 AUTH_FORBIDDEN을 반환합니다. live API 키는 두 모드를 선택할 수 있습니다.

응답

성공

data
object