4개 문서가 "API 설계" 태그에 분류되었습니다

부분 수정 API에서 null 필드의 오래된 모호함 — JSON Merge Patch·JSON Patch·필드 마스크를 비교하고, 바꿀 필드를 명시하는 permit 계약과 필드 단위 검증 패턴을 정리합니다.

API 응답을 도메인 모델에 맞출 것인가, 독립적으로 설계할 것인가 — 규칙이 아니라 트레이드오프입니다. 경계마다 옷을 갈아입는 DTO 레이어링과, 필드 전파를 컴파일러에게 맡기는 인터페이스 구현 강제까지 다룹니다.

같은 도메인의 API라도 호출자가 누구냐에 따라 퍼블릭·오퍼레이션·인터널로 나뉩니다. 인터널 API의 경계는 왜 네트워크가 아니라 도메인 사이에 그어지는지, 권한은 왜 퍼블릭에만 거는지를 다룹니다.

시간 필드를 API 계약에 어떻게 담을지 정리합니다. 절대시각과 로컬 날짜를 가르는 기준, 미래의 약속을 UTC로 저장하면 안 되는 이유, Temporal이 그 구분을 타입으로 강제하는 방식을 다룹니다.