이 누리집은 대한민국 공식 전자정부 누리집입니다.

서비스 이용 방법

1. 요청변수(request parameter)

요청변수(request parameter)
항목명 정의사항
serviceKey
  • API 인증키
  • ( 발급받은 인증키 )
postTextType
  • 조회방법
  • A : 주소 방식, W : 지하철인근
postDivType
  • 대상데이터
  • null = 전체 대상, 1 = 우체국, 2 = 우체통, 3 = 365코너, 4 = 무인창구, 5 = 우표판매소
postExtraBusinessType
  • 특수업무
  • null = 조건 없음, 1 = 펀드판매, 2 = 커피캡슐 리사이클링 백, 리사이클러 비치(커피캡슐 재활용 봉투, 재생 처리기 비치), 3 = ECO우체통, 4 = 알뜰폰판매
postExtraBusinessTerms
  • 특수업무 조회방법
  • and: 모든 조건 만족하는 값, or: 조건들 중 1개 이상 만족하는 값
postSearchText
  • 검색어
postOffiId
  • 지역코드 - 붙임파일 참조
postLongitude
  • 사용자 현위치 중 위도 : WGS84 좌표계
postLatitude
  • 사용자 현위치 중 경도 : WGS84 좌표계
postGap
  • 반경 거리 코드 : 1Km = 1, 0.5Km = 0.5
fundSaleYn
  • 펀드판매우체국 여부
  • Y = 판매, N = 판매하지않음
phoneSaleYn
  • 알뜰폰판매우체국 여부
  • Y = 판매, N = 판매하지않음
2. 응답메세지 정의 : xml 방식
<postListResponse>
  <postMsgHeader>
   <totalCount>3</totalCount>
   <pageCount>10</pageCount>
   <totalPage>1</totalPage>
   <nowPage>1</nowPage>
  </postMsgHeader>
  <postItem>
   <postId>10001</postId>
   <postDiv>1</postDiv>
   <postNm>서울소공동우체국</postNm>
   <postNmEn>Seoul Sogongdong Branch Post Office</postNmEn>
   <postTel>02-757-2660</postTel>
   <postFax>02-776-2660</postFax>
   <postAddr>서울 중구 남대문로1길 34, 1층 (북창동)</postAddr>
   <postAddrEn>34, Namdaemun-ro 1-gil, Jung-gu, Seoul</postAddrEn>
   <post365Yn>Y</post365Yn>
   <postTime>09:00~18:00</postTime>
   <postFinanceTime>09:00~16:30</postFinanceTime>
   <postServiceTime>05:00~익일:04:00</postServiceTime>
   <postLat>37.5625356</postLat>
   <postLon>126.9775329</postLon>
   <postSubWay>시청역</postSubWay>
   <postOffiId>100</postOffiId>
   <postExtraBusiness></postExtraBusiness>
   <postExtraBusinessDesc>없음</postExtraBusinessDesc>
   <fundSaleYn>N</fundSaleYn>
   <phoneSaleYn>N</phoneSaleYn>
   <partTimeYn>N</partTimeYn>
   <lunchTimeYn>N</lunchTimeYn>
   <lunchTime>null</lunchTime>
   <todayDepartureYn>Y</todayDepartureYn>
   <todayDepartureMailTime>17:30</todayDepartureMailTime>
   <postDesc/>
   <modDt>2018-05-30</modDt>
  </postItem>
</postListResponse>

우체국찾기OpenApi서비스.docx다운로드