자율차마스터정보 (제공)

자율주행 서비스의 자율 주행 차량 마스터 정보를 제공합니다.

1. 자율차마스터정보 제공 API (GetAutonomousCarMasterInfo)

요청 URL

https://service.mqnicrnd5.com/api/v1/acm/offer/gacm

연계 주기

요청 시

프로토콜

HTTPS

HTTP 메서드

GET

데이터 포맷

110KB

자율차마스터정보(제공)_gacm.pdf

PDF

Open

참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. 접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.

> GET /api/v1/acm/offer/gacm?serviceNo=11&historyFlag=y HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>

과제 번호(serviceNo) 및 차량유형(vehicleType) 작성 규칙

과제 번호(serviceNo) 작성규칙

국토교통부 : ‘k’+ 과제번호(1~99)
산업통상자원부 : ‘s’+ 과제번호(1~99)
경찰청 : ‘p’ + 과제번호(1~99)
과제 외 신규코드 (100..65535)

과제 번호(serviceNo) 예시

국-10 : k10
산-12 : s12
경-13 : p13

차량유형(vehicleType) 작성 규칙

연료 유형 + 차량 유형과 을 조합하여 구성
ex. 승용 전기차 = > ‘Y10’

1.차량 유형 (국토부 자동차 등록 통계의 차종 재구성)

10 : 승용
20 : 승합
21 : 승합_15인이하
22 : 승합_25인이하
23 : 승합_35인 이하
24 : 승합_35인 초과
30 : 화물
31 : 화물_픽업
32 : 화물_덤프
33 : 화물_밴형
34 : 화물_특수
40 : 특수

2.연료 유형(국토부 자동차 등록 통계 연료 유형 재구성)

G : 휘발유
D : 경유
L : LPG
C : CNG
E : 전기
H : 수소
Y : 하이브리드

요청 예시

curl --location 'https://service.mqnicrnd5.com/api/v1/acm/offer/gacm?serviceNo=11&historyFlag=y' \
--header 'Authorization: Bearer <접근 토큰>'

응답 예시

{
    "autonomousCarMaster": [
        {
            "vehicleId": "99371",
            "serviceNo": "k10",
            "vehicleType": "Y10",
            "maker": "",
            "modelNm":"",
            "noplt":"",
            "updateType": "I",
            "updateDttm": "20240617142040"
        },
        {
            "vehicleId": "99372",
            "serviceNo": "k10",
            "vehicleType": "Y10",
            "maker": "",
            "modelNm":"",
            "noplt":"",
            "updateType": "I",
            "updateDttm": "20240617144600"
        },
        {
            "vehicleId": "99373",
            "serviceNo": "k10",
            "vehicleType": "Y10",
            "maker": "",
            "modelNm":"",
            "noplt":"",
            "updateType": "U",
            "updateDttm": "20240617144900"
        }
    ]
}

2. 자율차마스터정보 제공 API 구현 예제

자율차마스터정보 제공 API (GetAutonomousCarMasterInfo)


import java.io.*;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.util.HashMap;
import java.util.Map;
import java.net.URI;
import java.net.URISyntaxException;
import java.net.URL;
import java.net.HttpURLConnection;

public class CallAPI {

    public static void main(String[] args) {
        String accessToken = "Bearer " + "<접근 토큰>";

        String serviceNo = "k12";
        String vehicleType = "";
        String historyFlag = "y";

        String apiURL = "https://service.mqnicrnd5.com/api/v1/acm/offer/gacm?"
                + "serviceNo=" + serviceNo + "&"
                + "vehicleType=" + vehicleType + "&"
                + "historyFlag=" + historyFlag;

        Map<String, String> requestHeaders = new HashMap<>();
        requestHeaders.put("Authorization", accessToken);
        String responseBody = get(apiURL,requestHeaders);

        System.out.println(responseBody);
    }


    private static String get(String apiUrl, Map<String, String> requestHeaders) {
        HttpURLConnection con = connect(apiUrl);
        try {
            con.setRequestMethod("GET");
            for (Map.Entry<String, String> header : requestHeaders.entrySet()) {
                con.setRequestProperty(header.getKey(), header.getValue());
            }

            int responseCode = con.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) { // 정상 호출
                return readBody(con.getInputStream());
            } else { // 오류 발생
                return readBody(con.getErrorStream());
            }
        } catch (IOException e) {
            throw new RuntimeException(e);
        } finally {
            con.disconnect();
        }
    }


    private static HttpURLConnection connect(String apiUrl) {
        try {
            URI uri = URI.create(apiUrl);   
            URL url = uri.toURL();       
            return (HttpURLConnection) url.openConnection();
        } catch (MalformedURLException e) {
            throw new RuntimeException("API URL이 잘못되었습니다. : " + apiUrl, e);
        } catch (IOException e) {
            throw new RuntimeException("연결이 실패했습니다. : " + apiUrl, e);
        }
    }


    private static String readBody(InputStream body) {
        InputStreamReader streamReader = new InputStreamReader(body);


        try (BufferedReader lineReader = new BufferedReader(streamReader)) {
            StringBuilder responseBody = new StringBuilder();


            String line;
            while ((line = lineReader.readLine()) != null) {
                responseBody.append(line);
            }


            return responseBody.toString();
        } catch (IOException e) {
            throw new RuntimeException("API 응답을 읽는 데 실패했습니다.", e);
        }
    }

}


import requests
import json

def send_get_request():

    accessToken = "Bearer " + "<접근 토큰>"

    serviceNo = "k12"
    vehicleType = ""
    historyFlag = "y"

    apiURL = "https://service.mqnicrnd5.com/api/v1/acm/offer/gacm?" \
        + "serviceNo=" + str(serviceNo) + "&" \
        + "vehicleType=" + str(vehicleType) + "&" \
        + "historyFlag=" + str(historyFlag) 
   
    headers = {
        "Authorization": accessToken
    }
    
    response = requests.get(apiURL, headers=headers)
    
    print("GET Request:")
    print("Response Code:", response.status_code)
    print("Response:", response.text)

if __name__ == "__main__":
    send_get_request()


const https = require('https');

function main() {
    const accessToken = "Bearer <접근 토큰>";
    
    const serviceNo = "k12";
    const vehicleType = "";
    const historyFlag = "y";

    const apiURL = `https://service.mqnicrnd5.com/api/v1/acm/offer/gacm?serviceNo=${serviceNo}&vehicleType=${vehicleType}&historyFlag=${historyFlag}`;

    const headers = {
        'Authorization': accessToken
    };

    get(apiURL, headers)
        .then(responseBody => {
            console.log(responseBody);
        })
        .catch(error => {
            console.error('Error:', error);
        });
}

function get(apiURL, headers) {
    return new Promise((resolve, reject) => {
        const options = {
            headers: headers
        };

        https.get(apiURL, options, response => {
            let data = '';
            response.on('data', chunk => {
                data += chunk;
            });

            response.on('end', () => {
                resolve(data);
            });
        }).on('error', error => {
            reject(error);
        });
    });
}

main();


using System;
using System.IO;
using System.Net;
using System.Text;

class Program
{
    static void Main(string[] args)
    {
        string accessToken = "Bearer <접근 토큰>";
        
        string serviceNo = "k12";
        string vehicleType = "";
        string historyFlag = "y";
       
        string apiURL = $"https://service.mqnicrnd5.com/api/v1/acm/offer/gacm?serviceNo={serviceNo}&vehicleType={vehicleType}&historyFlag={historyFlag}";

        string responseBody = Get(apiURL, accessToken);

        Console.WriteLine(responseBody);
    }

    static string Get(string apiUrl, string accessToken)
    {
        try
        {
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(apiUrl);
            request.Method = "GET";
            request.Headers["Authorization"] = accessToken;

            using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
            using (Stream stream = response.GetResponseStream())
            using (StreamReader reader = new StreamReader(stream, Encoding.UTF8))
            {
                return reader.ReadToEnd();
            }
        }
        catch (WebException e)
        {
            using (WebResponse response = e.Response)
            using (Stream dataStream = response.GetResponseStream())
            using (StreamReader reader = new StreamReader(dataStream))
            {
                string errorResponse = reader.ReadToEnd();
                throw new Exception($"Error occurred: {errorResponse}", e);
            }
        }
    }
}

Previous자율차마스터정보 (수집)Next미시교통정보 (제공)

Last updated 1 day ago

hashtag1. 자율차마스터정보 제공 API (GetAutonomousCarMasterInfo)

hashtag요청 URL

hashtag연계 주기

hashtag프로토콜

hashtagHTTP 메서드

hashtag데이터 포맷

hashtag참고사항

hashtag과제 번호(serviceNo) 및 차량유형(vehicleType) 작성 규칙

hashtag과제 번호(serviceNo) 작성규칙

hashtag차량유형(vehicleType) 작성 규칙

hashtag요청 예시

hashtag응답 예시

hashtag2. 자율차마스터정보 제공 API 구현 예제

hashtag자율차마스터정보 제공 API (GetAutonomousCarMasterInfo)