API 개요

권위

API와 schema의 SSOT는 contract repository다. 이 사이트는 고정된 contract commit에서 OpenAPI와 TypeDoc을 생성하며, hand-written schema나 client type을 별도로 유지하지 않는다.

Public contract외부 actor·frontend가 소비하는 계약의 범위와 생성 원칙.

Contract versioning호환 범위, additive 변경, 제거 규칙.

Backend authorityAPI 뒤의 authorization과 database defense.

Actor acceptance생성 계약이 실제 workflow에서 검증된 범위.

읽는 순서

actor가 직접 소비하면 왼쪽 API topic의 Public API, 내부 service orchestration이면 Internal API를 연다. TypeScript client도 같은 topic에 생성된다. 요청·응답 의미는 endpoint schema를 따르고, 변경 순서와 호환성은 Contract versioning을 따른다.