2026 개발 트렌드: OpenAPI Overlay가 늘수록, API 설명도 배포 가능한 구성 자산이 된다
OpenAPI 원본 계약에 문서·환경·소비자별 변경을 겹쳐 쓰는 Overlay가 늘면서, API 설명을 단일 YAML 파일이 아니라 검증·diff·승인·배포가 필요한 구성 자산으로 운영해야 하는 이유를 정리합니다.
아카이브 글
백엔드 커리큘럼 심화: Protobuf 스키마 진화, 필드 번호와 의미를 함께 지키는 호환성 플레이북
Protobuf·gRPC 계약을 바꿀 때 필드 번호, presence, enum, JSON 변환, producer·consumer 배포 순서를 함께 관리해 조용한 데이터 손실과 롤백 불능 배포를 막는 방법을 정리합니다.
백엔드 커리큘럼 심화: PATCH API를 Merge Patch·JSON Patch·Field Mask와 동시성 계약으로 설계하는 법
PATCH를 단순히 '일부 필드 수정'으로 두지 않고, 표현식 선택·도메인 검증·If-Match·오류 의미·감사 로그를 하나의 변경 계약으로 설계하는 실무 플레이북입니다.