# 웹훅

### 개요

배포 상태와 관계없이 배포가 완료되었을 때를 아는 것은 종종 유용합니다 `준비됨` 또는 `오류`입니다. 배포에 웹후크를 사용할 수 있습니다. 작동 방식은 다음과 같습니다:

배포가 완료되면 제공된 URL로 HTTP POST 요청을 보냅니다. 이 요청에는 우리의 라우트가 제공하는 것과 동일한 데이터가 포함된 JSON 본문이 포함됩니다 `/v1/status/{request_id}`입니다. 귀측의 응답은 기대하지 않습니다.

{% hint style="warning" %}
웹후크의 기본 타임아웃은 10초입니다. 이 시간 내에 웹후크가 응답하지 않으면 추가 알림을 받지 못합니다.
{% endhint %}

### 배포 웹후크 예시

`POST` 요청 대상 `/v1/deploy` ([API 참고](https://docs.edgegap.com/docs.edgegap.com-ko/docs/api))

다음과 같이 [API 토큰](https://docs.edgegap.com/docs.edgegap.com-ko/docs/deployment/broken-reference) 을(를) 헤더에 포함하세요:

```json
{
  "Content-Type": "application/json",
  "Authorization": "token super_secret_token_1234"
}
```

REST 페이로드:

```json
{
  "app_name": "speedtest",
  "version_name": "v1",
  "ip_list": ["1.1.1.1"],
  "webhook_url": "https://ptsv2.com/t/0n7by-1652897234/post"
}
```

### 배포 웹후크 호출 흐름

다음 시퀀스 다이어그램은 배포 웹후크의 호출 흐름을 보여줍니다.

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-414bdc54920e91653a634052addc6ae63ab5fb1f%2Farbitrium_deploy_webhook_flow.png?alt=media" alt=""><figcaption></figcaption></figure>