Cheondi

Independent Technology Review

Cheondi Review

Issue 06 June 2026

  • Arazzo
  • Idempotency
  • Retry Budget
  • API Workflow

API Workflow

API 한 번 호출보다 전체 흐름을 설명하는 방법

여러 API 호출의 순서, 입력 의존성, 성공 조건을 하나의 결과 중심 워크플로로 표현하는 Arazzo 1.1.0을 살펴본다.

API 명세가 각 요청의 모양을 알려준다면 운영에서 필요한 건 요청 사이의 상태 전이와 실패 지점을 함께 설명하는 문서다.

OpenAPI Initiative · Frank Kilcommins, Nick Denny, Kevin Duffey ·

The Arazzo Specification v1.1.0: 원문 GitHub 내 포스팅

Idempotency

중복 요청을 다루는 Idempotency-Key 계약

같은 작업의 재시도를 서버가 구분할 수 있도록 키의 유일성, 만료, fingerprint와 오류 응답을 제안한 Internet-Draft를 읽는다.

만료된 작업 문서이므로 표준처럼 기대기보다, 중복 실행 방지 정책에서 빠진 질문을 찾는 체크리스트로 보는 편이 맞다.

IETF Datatracker · IETF HTTPAPI Working Group ·

The Idempotency-Key HTTP Header Field: 원문 GitHub 내 포스팅

Retry Control

재시도 폭주를 막는 Retry Budget

Gateway API v1.3의 retry budget이 요청량 대비 재시도 비율을 제한해 장애 중 증폭을 막는 방식을 소개한다.

재시도 횟수만 정하면 각 인스턴스가 동시에 반복할 수 있으니 전체 트래픽에서 허용할 실패 비용을 같이 봐야 한다.

Kubernetes Blog · Kubernetes SIG Network ·

Gateway API v1.3: New Features: 원문 GitHub 내 포스팅

Source Code Shelf

이번 호와 함께 펼쳐볼 저장소

OpenAPI Initiative Markdown

OAI/Arazzo-Specification

API 호출 순서와 의존성을 기술하는 Arazzo 명세, 스키마, 변경 이력을 확인할 수 있다.

저장소 보기

IETF HTTPAPI XML

ietf-wg-httpapi/idempotency

Idempotency-Key Internet-Draft의 편집 이력과 논의를 추적할 수 있는 작업 저장소다.

저장소 보기

Kubernetes SIG Network Go

kubernetes-sigs/gateway-api

Gateway API 타입과 controller conformance에서 retry 정책이 실제로 표현되는 방식을 읽을 수 있다.

저장소 보기

Cheondi's Desk

Failure Boundary

API 워크플로와 재시도 경계

생성 요청부터 callback, requery, 최종 상태 확인까지 한 흐름으로 보고 안전하게 재시도하는 기준을 정리한 기록이다.

참고 자료 3개 · 코드 저장소 3개

개인 기록 읽기

직접 읽고 고른 글을 짧게 소개합니다. 원문의 저작권은 각 작성자와 발행처에 있으며, 전문 대신 출처와 연결되는 독서 메모만 남깁니다.