점검 진행 중 — 나중에 다시 시도해 주세요.

🕊️

HATO API

비둘기 우체국

01 / 배달 정책

배달 정책이란 무엇인가요?

비둘기는 배달을 담당하는 직원입니다. 배달 정책은 비둘기가 따르는 타임아웃, 재시도, HTTP 설정, 크기 제한을 모은 공유 설정입니다. 각 Letter에 사용할 정책을 선택하세요.

비둘기의 배달 방법 설정

HTTP 버전

기본값은 HTTP/2이며 HTTP/1.1로 협상할 수 있습니다. HTTP/3는 QUIC을 활성화하고 지원되는 이전 버전으로 폴백할 수 있습니다. 선호 설정이 서버의 실제 사용 버전을 보장하지는 않습니다.

두 가지 시간 제한

연결 시간 제한은 서버에 연결하는 대기 시간을, 응답 시간 제한은 서버 응답 대기 시간을 제한합니다. 느린 배달을 무기한 기다리지 않도록 대상에 맞는 값을 선택하세요.

재시도 정책

추가 시도를 최대 세 번까지 선택하고 재시도를 유발할 연결 오류나 HTTP 상태를 지정하세요. 재시도 횟수는 리디렉션을 포함한 Letter 전체에서 공유되며 실패한 홉만 재시도합니다.

페이로드 한도

요청과 응답의 헤더 및 본문 한도를 설정하세요. 배달 정책은 플랜보다 작은 본문 한도를 사용할 수 있지만 플랜 상한을 높일 수는 없습니다.

한 번 만들고 알맞게 재사용하기

  1. 배달 정책을 만드세요.

    대시보드의 배달 정책에서 정책을 만드세요. 특정 URL보다는 스테이징 API처럼 용도를 알 수 있는 이름을 지정하세요.

  2. Letter에 지정하세요.

    각 Letterflow 구성 요소에서 배달 정책을 선택하세요. 배달 정책은 지역과 독립적이며 각 Letter에서 실행 지역을 선택합니다.

  3. 편집 전에 공유 설정을 확인하세요.

    변경 사항은 이후 배달에 적용됩니다. 승인된 실행은 기록된 설정을 유지합니다. 정책을 삭제해도 Letterflow 구성 요소는 유지됩니다. 다시 실행하기 전에 다른 정책을 선택하세요.

선호 설정과 실제 배달

배달 정책 배지는 선택한 HTTP 버전을 표시합니다. Letterbox에서 결과를 열면 최종 응답에서 협상된 '사용된 HTTP 버전'을 확인할 수 있습니다.

상태를 변경하는 요청을 재시도하면 작업이 중복될 수 있습니다. 대상이 지원하면 멱등성 기능을 사용하세요.