오픈 API
주유소 상세정보(ID) 오픈 API 정보
■ 기본정보
- URL 정보 https://www.opinet.co.kr/api/detailById.do
- 특정 주유소(ID)에 대한 기본정보 및 가격정보 등 상세정보
■ 요청 파라미터
| Element | Description | |
|---|---|---|
| certkey | 필수 | 공사에서 부여한 인증키 정보 |
| out | 필수 | 정보 노출 형식을 정의 한다.(xml/json) |
| id | 필수 | 주유소 ID |
■ 반환값
| Element | Description | |
|---|---|---|
| UNI_ID | 주유소코드 | |
| POLL_DIV_CD | 상표(SKE:SK에너지, GSC:GS칼텍스, HDO:현대오일뱅크, SOL:S-OIL, RTE:자영알뜰, RTX:고속도로알뜰, NHO:농협알뜰, ETC:자가상표, E1G: E1, SKG:SK가스) | |
| GPOLL_DIV_CD | ||
| OS_NM | 상호 | |
| VAN_ADR | 지번주소 | |
| NEW_ADR | 도로명주소 | |
| TEL | 전화번호 | |
| SIGUNCD | 소재지역 시군코드 | |
| LPG_YN | 업종구분 (N:주유소, Y:자동차충전소, C:주유소/충전소 겸업) | |
| MAINT_YN | 경정비 시설 존재 여부 | |
| CAR_WASH_YN | 세차장 존재 여부 | |
| KPETRO_YN | 품질인증주유소 여부 (한국석유관리원의 품질인증프로그램 협약 업체) | |
| CVS_YN | 편의점 존재 여부 | |
| GIS_X_COOR | GIS X좌표(KATEC) | |
| GIS_Y_COOR | GIS Y좌표(KATEC) | |
| OIL_PRICE | PRODCD | B027:휘발유, D047:경유, B034:고급휘발유, C004:실내등유, K015:자동차부탄 |
| PRICE | 판매가격 | |
| TRADE_DT | 기준일자 | |
| TRADE_TM | 기준시간 | |
■ 사용예시
REQUEST https://www.opinet.co.kr/api/detailById.do?out=xml&id=A0010207&certkey=[인증키]
RESPONSE
<?xml version="1.0" encoding="UTF-8"?>
<RESULT>
<OIL>
<UNI_ID>A0010207</UNI_ID>
<POLL_DIV_CO>SKE</POLL_DIV_CO>
<GPOLL_DIV_CO> </GPOLL_DIV_CO>
<OS_NM>SK서광주유소</OS_NM>
<VAN_ADR>서울 강남구 역삼동 834-47</VAN_ADR>
<NEW_ADR>서울 강남구 역삼로 142</NEW_ADR>
<TEL>02-562-4855</TEL>
<SIGUNCD>0113</SIGUNCD>
<LPG_YN>N</LPG_YN>
<MAINT_YN>Y</MAINT_YN>
<CAR_WASH_YN>Y</CAR_WASH_YN>
<CVS_YN>N</CVS_YN>
<KPETRO_YN>N</KPETRO_YN>
<GIS_X_COOR>314871.80000</GIS_X_COOR>
<GIS_Y_COOR>544012.00000</GIS_Y_COOR>
<OIL_PRICE>
<PRODCD>B027</PRODCD>
<PRICE>1745</PRICE>
<TRADE_DT>20250723</TRADE_DT>
<TRADE_TM>145618</TRADE_TM>
</OIL_PRICE>
<OIL_PRICE>
<PRODCD>B034</PRODCD>
<PRICE>1920</PRICE>
<TRADE_DT>20250723</TRADE_DT>
<TRADE_TM>145312</TRADE_TM>
</OIL_PRICE>
<OIL_PRICE>
<PRODCD>D047</PRODCD>
<PRICE>1629</PRICE>
<TRADE_DT>20250723</TRADE_DT>
<TRADE_TM>144009</TRADE_TM>
</OIL_PRICE>
</OIL>
</RESULT>
