---
title: "웹훅 주소 등록"
method: POST
path: "/api/webhooks"
---

# 웹훅 주소 등록

`POST /api/webhooks`

## Request

- Base URL: `https://aiwave.elopstudio.com`
- URL: `https://aiwave.elopstudio.com/api/webhooks`
- Auth: HTTP bearer

변경이 생기면 이 주소로 사건 하나당 한 번 POST 한다. 본문은 `{timestamp}.{body}` 를 비밀키로 HMAC-SHA256 서명해 `x-aiwave-signature: sha256=<hex>` 로 보낸다. 300초가 지난 요청은 받는 쪽이 버려야 한다. 비밀키는 **이 응답에서만** 나간다.

## Request body

- object
  - `url` string, uri, required: https 공개 주소만 받는다.
  - `eventTypes` string[]: 생략하면 전부.
  - `vendor` string, nullable: 벤더 슬러그로 거른다. 생략하면 전부.

## Response `200`

등록됨. secret 이 함께 온다.

## Other responses

- `400`: 주소가 https 가 아니거나 사설 대역이다.
- `401`: 로그인 필요

---

[API](https://skmtc.dev/elopstudio/apis/ai-wave-api.md) · [All operations](https://skmtc.dev/elopstudio/apis/ai-wave-api/llms.txt) · [OpenAPI document](https://skmtc.dev/elopstudio/apis/ai-wave-api/revisions/5598fac87fef?raw)