delivery-tracker icon indicating copy to clipboard operation
delivery-tracker copied to clipboard

우체국택배 API Endpoint 업데이트 요청

Open kimiroo opened this issue 8 months ago • 1 comments

정부에서 제공하는 OPENAPI 중 우체국 국내/국제 등기 조회를 할 수 있는 API를 발견하여 제보드립니다.

공공데이터포털 링크: https://www.data.go.kr/data/15035122/openapi.do

위 링크에서 활용 신청 후 API Key를 받아 요청하면 됩니다. 일일 Quota는 10000건으로 보이며, 추가 신청시 증량이 가능한 것으로 보입니다.

Endpoint: http://openapi.epost.go.kr/trace/retrieveLongitudinalCombinedService/retrieveLongitudinalCombinedService/getLongitudinalCombinedList?serviceKey={서비스키}&rgist={송장번호}

Response:

<?xml
version="1.0" encoding="UTF-8" standalone="yes"?>
<response>
    <header>
        <requestRegiNo>{송장번호}</requestRegiNo>
        <responseTime>2024-06-13 22:09:55</responseTime>
        <successYN>Y</successYN>
        <errorMessage></errorMessage>
    </header>
    <trackInfo>
        <regiNo>6892058349240</regiNo>
        <senderName>{개인정보}</senderName>
        <senderData>2024-04-18</senderData>
        <receiveName>{개인정보}</receiveName>
        <receiveDate>2024-04-19</receiveDate>
        <trackState>배달완료</trackState>
        <expressType></expressType>
        <detaileTrackList>
            <sortNo>0</sortNo>
            <date>2024-04-18</date>
            <time>13:47</time>
            <statue>접수 </statue>
            <location>서울종로2가우체국</location>
            <remark></remark>
        </detaileTrackList>
        <detaileTrackList>
            <sortNo>1</sortNo>
            <date>2024-04-18</date>
            <time>17:37</time>
            <statue>발송 </statue>
            <location>서울종로2가우체국</location>
            <remark></remark>
        </detaileTrackList>
        <detaileTrackList>
            <sortNo>2</sortNo>
            <date>2024-04-18</date>
            <time>18:41</time>
            <statue>도착 </statue>
            <location>동서울우편집중국</location>
            <remark></remark>
        </detaileTrackList>
        <detaileTrackList>
            <sortNo>3</sortNo>
            <date>2024-04-19</date>
            <time>06:42</time>
            <statue>배달준비 </statue>
            <location>서울용산우체국</location>
            <remark></remark>
        </detaileTrackList>
        <detaileTrackList>
            <sortNo>4</sortNo>
            <date>2024-04-19</date>
            <time>09:56</time>
            <statue>배달완료 (배달)
 (수령인:김**님 - 본인)
</statue>
            <location>서울용산우체국</location>
            <remark></remark>
        </detaileTrackList>
    </trackInfo>
</response>

사용 방법:

  • URL에 변수를 encode해서 넣은 뒤 GET요청을 날리면 됩니다.

유의사항:

  • HTTPS가 지원되지 않습니다.

kimiroo avatar Jun 13 '24 13:06 kimiroo