과학기술정보통신부 우정사업본부_국내우편물 종적 조회 서비스

우체국 등기번호(13자리)를 이용하여 건별 국내등기우편물의 배송내역을 조회하는 OPEN API 서비스입니다. ㅇ 출력하는 항목(사용자가 응답 받게 되는 데이터) : 발송인, 수취인, 등기번호, 우편물종류, 취급구분, 배달일자, 배달상태, 종적목록(날짜, 시간, 현재위치, 처리현황, 상세설명)이 문서는 우정사업본부의 국내우편물 배송조회 서비스를 공공데이터 오픈API 형태로 제공하기 위한 기술 명세서로,서비스 개요와 오퍼레이션 구성, 건별 국내우편물 등기 종적조회 기능에 대한 상세 내용을 포함합니다.특히, 각 오퍼레이션별 요청 및 응답 메시지 구조와 항목 정의를 중심으로 구성되어 있으며,API 호출 시 필요한 데이터 형식과 처리 방식에 대한 기준을 제공합니다.또한, 개발자가 배송조회 기능을 시스템에 연동할 수 있도록 요청·응답 메시지 명세를 명확히 제시하고,국내우편물의 배송 상태를 조회하기 위한 핵심 기능과 데이터 흐름을 이해할 수 있도록 지원합니다.이를 통해 배송추적 서비스 구현 시 필요한 기술적 기준을 제공하고, 안정적인 데이터 연동 및 활용이 가능하도록 돕는 규격서 역할을 수행합니다.

날짜 등기번호 발송인 배달상태 배달일자 상세설명 수취인 시간 우편물종류 처리현황 취급구분 현재위치

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '등기번호=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "등기번호": "값",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "등기번호": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())