핵심 요점

  • 표시용 주소와 저장 필드를 구분합니다.
  • 상세주소는 선택 입력을 기본으로 합니다.
  • 주소 형식 검사는 실제 거주자 확인이 아닙니다.

작성 및 검토

편집 및 검토 원칙
작성
RZTKB Editorial Team
검토
RZTKB Data Review
최근 주요 업데이트
2026-08-28

첫 번째 주소 줄에 넣을 값

첫 번째 줄에는 도로명과 건물번호를 둡니다. 시·도와 시·군·구를 별도 선택 필드로 받는 서비스라면 같은 내용을 중복 입력하게 만들지 않는 것이 좋습니다. 사용자가 붙여넣은 전체 주소는 원문으로 보관하면 수정 과정도 추적하기 쉽습니다.

상세주소를 선택 항목으로 다루기

동·층·호와 건물명은 모든 주소에 존재하지 않습니다. 필수 입력으로 고정하면 단독 건물이나 공공시설 테스트가 실패합니다. 상세주소가 비어 있어도 저장과 다음 단계 이동이 정상인지 확인합니다.

형식 예시
addressLine1: 부산광역시 해운대구 센텀중앙로 97addressLine2: A동 1204호postalCode: 48058

자동완성과 수동 수정

우편번호 검색이나 주소 자동완성은 입력을 돕지만 최종 판단은 사용자가 합니다. 자동완성된 도로명 주소 뒤에 상세주소를 입력하고, 이전 단계로 돌아갔을 때 값이 사라지지 않는지 점검합니다.

QA에서 놓치기 쉬운 경우

긴 도로명, 같은 건물의 여러 동, 하이픈 포함 번호, 모바일 키보드, 복사·붙여넣기를 포함합니다. 서버가 받은 JSON과 확인 화면의 주소 줄을 비교해 중복이 없는지 살펴봅니다.

자주 묻는 질문

도로명 주소와 상세주소를 한 칸에 써도 되나요?

표시는 가능하지만 저장은 분리하는 편이 유리합니다.

우편번호 검색 결과를 그대로 믿어도 되나요?

사용자가 확인하고 수정할 수 있어야 합니다.

건물명이 없으면 어떻게 하나요?

상세주소를 비워 둡니다.

테스트 주소로 배송해도 되나요?

안 됩니다. 배송 가능 여부를 확인한 데이터가 아닙니다.

출처 및 추가 자료

  1. 만국우편연합 주소 자료
  2. RZTKB data methodology