📢 우편번호 서비스 도메인 및 API 네임스페이스 변경 안내

[daumPostcode]

📢 우편번호 서비스 도메인 및 API 네임스페이스 변경 안내

안녕하세요.
우편번호 서비스 API 담당자입니다.

우편번호 서비스 이용과 관련하여 도메인 및 JavaScript API 네임스페이스 변경 사항을 안내드립니다.

---

1. 공식 가이드 페이지 안내

현재 운영 중인 우편번호 서비스 공식 가이드 페이지는 아래 링크에서 확인하실 수 있습니다.

👉 https://postcode.map.daum.net/guide

※ 해당 가이드 페이지 역시 2026년 3월 10일(화) 이후
postcode.map.kakao.com 도메인으로 이전될 예정입니다.

---

2. CDN 도메인 변경 (적용 완료)

일부 정적 리소스(CDN) 도메인이 아래와 같이 변경되었습니다.

• 기존: t1.daumcdn.net
• 변경: t1.kakaocdn.net

기존 도메인(t1.daumcdn.net)도 당분간 계속 사용 가능하지만,
가능한 경우 신규 도메인(t1.kakaocdn.net) 사용을 권장드립니다.

---

3. 서비스 도메인 변경 일정 (예정)

2026년 3월 10일(화) 에 아래 도메인이 변경될 예정입니다.

구분	기존 도메인	변경 도메인
공식 가이드 / 서비스 팝업	postcode.map.daum.net	postcode.map.kakao.com

변경 이후에도 일정 기간 동안 기존·신규 도메인을 병행 운영 할 예정이며,
기존 도메인 종료 시점(2026년 4~5월 예정) 은 차기 공지(3월)를 통해 정확한 일정으로 다시 안내드리겠습니다.

---

4. JavaScript API 네임스페이스 변경 안내

JavaScript API 사용 시 생성자 네임스페이스가 변경되었습니다.

기존

new daum.Postcode({
    oncomplete: function (data) {
        // 처리 로직
    }
}).open();

변경 (권장)

new kakao.Postcode({
    oncomplete: function (data) {
        // 처리 로직
    }
}).open();

• daum.Postcode는 강제 변경되지 않으며,
  가능한 한 오랜 기간 동안 호환성 유지를 목표로 지원할 예정입니다.
• 다만, 신규 개발 및 유지보수 관점에서
  점진적으로 kakao.Postcode 사용을 권장드립니다.

---

5. 서비스 종료 예정 도메인 안내 (중요)

과거 가이드 페이지에서 이미 제거된 아래 도메인에 연결된 API는
2026년 4~5월 도메인 최종 전환 시점에 서비스가 종료될 예정입니다.

• dmaps.daum.net
• ssl.daumcdn.net

해당 도메인을 사용 중인 경우,
반드시 신규 Kakao 도메인 및 API로 이전해 주시기 바랍니다.

---

6. 참고 사항

• 본 공지는 도메인 변경 사전 안내 및 네임스페이스 변경에 대한 안내입니다.
• 기존 도메인 종료에 대한 상세 일정은 3월 10일 전후 공지에서 다시 안내드릴 예정입니다.
• 서비스 중단 방지를 위해 사전 점검 및 점진적 전환을 권장드립니다.
• 해당 안내사항 관련하여 질문이 있으신 경우 언제든지 이슈로 등록 부탁드립니다.

---

감사합니다.

[SayisMe]

도메인 변경하여 패치 코드를 작성하였습니다.
패치 코드로 빌드하였을 때에도
하기 이미지와 같이 '공지사항을 확인해주세요' UI가 노출되는 것이 정상 동작인건지 확인차 코멘트 남깁니다. 감사합니다.

[daumPostcode]

@SayisMe
네 해당 공지가 뜨는 것은 의도한 것으로 정상적인 동작입니다.
우편번호서비스 API는 developers에 등록되지 않아. 사용자 & 개발자에게 내용을 전달할 방법이 제한적입니다.

그래서 현재 깃허브 이슈 공지, 카카오톡채널 메세지발송(친구만), 그리고 서비스내 공지 표시입니다.

이중에 그간 제일 효과가 좋았던게 서비스내 공지였기에; 이번에도 동일하게 게시한 상태입니다.

해당 공지의 경우 이번주에 시작으로 최소 일주일간은 유지할 계속입니다.

이부분 참고 부탁드립니다.

추가로. 해당공지영역는 이번 업데이트와는 직접적인 연관은 없으며; 필요할때 띄우는 공지사항 영역이라 생각하시면 되십니다. 감사합니다.

[SayisMe]

@daumPostcode 빠른 피드백 감사드립니다 ! 👍🏻👍🏻

[handsomekbs10-sys]

이거 공지요 postcode.map.kakao.com 이걸로 변경해서 사용하는 사람들은 안나오게 할수 있는 방법 없나요? 회원들이 주소 입력할때 입력창 바로 위에 떠서 혼란스러울꺼 같은데

[noseunglim777]

IP랑 포트는 그대로인가요?

[Victor-Ko]

"react-daum-postcode": "^3.1.1"
npm으로 사용중인데 그대로 유지해도 문제 없나요?

[yondo123]

"react-daum-postcode": "^3.1.1" npm으로 사용중인데 그대로 유지해도 문제 없나요?
kmsbernard/react-daum-postcode#77

[chash428]

i1.daumcdn.net 은 변경 없는건가요???

[daumPostcode]

안녕하세요. 한분씩 답변 드리겠습니다.

@handsomekbs10-sys
공지할 내용이 있으면 뜨는거라, 현재 상황에서 도메인 체크는 어렵습니다. 다만 다음주 중반까지 띄워두고 그 이후에 내릴 예정입니다. 우편번호서비스는 앞서 다른 분의 문의의 댓글처럼 사용자 공지가 매우 어렵습니다. 9년째 운영하면서 제일 효과가 좋은게 서비스에 띄우는 것이라 양해 부탁드립니다.

@noseunglim777
아뇨 달라집니다. 그래서 공지를 하는 것인데요. 기본적으로 우편번호서비스는 내부망에서의 활용을 공식지원하지 않습니다. 하지만 도메인으로 IP확인하여 쓰시는 분들이 계시기에 공지를 하는 내용으로, 3월 10일에 서비스에 도메인이 붙을건데; 그때는 두 도메인 모두 접근이 가능하기에 그때 IP확인하여 바꿔주시기 바랍니다.

@Victor-Ko
해당 라이브러리 제작자분께 말씀해 보셔야 될것 같습니다.
기본적으로 도메인 변경건이고, 저희 API를 랩핑한 것이기 때문에, 제가 바꾸면 자동 적용이 될텐데요. 그분께 JS API도메인만 바꿔달라고 요청하셔도 될것 같습니다.
PR 보니 이미 적용진행 중이시네요 ㅎㅎ

@chash428
i1.daumcdn은 안쓴지 오래된 도메인입니다. 현재는 t1.kakaocdn.net으로 변경되었습니다.