자율차마스터정보 (수집)

자율주행 서비스의 자율 주행 차량 마스터 정보를 수집하여 플랫폼 내에 적재하는 기능을 제공합니다.

1. 자율차마스터정보 수집 API (PostAutonomousCarMasterInfo)

요청 URL

https://service.mqnicrnd5.com/api/v1/acm/collect/pacm

연계 주기

일정 주기 마다 (추후 안내 예정), 변경 시

프로토콜

HTTPS

HTTP 메서드

POST

데이터 포맷

107KB

자율차마스터정보(수집)_pacm.pdf

PDF

Open

과제 번호(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 : 하이브리드

사용법

• 정보 갱신 유형(I : 추가, U : 변경, D : 삭제)

• 차량 부분갱신 할 경우

  • deltaUpdateFlag = 'y' 으로 전송

  • autonomousCarMaster 리스트에 담긴 차량 정보가 추가로 갱신됩니다.

  • 전체 차량에 대해서도 부분갱신으로 전송 가능합니다.

  • 정보 갱신 유형은 updateType 필드를 사용하세요.

• 차량 전체갱신 할 경우

  • deltaUpdateFlag = 'n' 으로 전송

  • autonomousCarMaster 리스트에 담긴 차량 정보로 전체 갱신 되며, 해당 리스트에 존재하지 않는 차량은 삭제됩니다.

  • autonomousCarMaster 리스트에는 해당 과제나 시스템의 전체 자율차 정보를 제공해주세요.

  • 정보 갱신 유형은 updateType = 'I' 로 하여 전송해주세요. 변경이 없는 차량의 경우도 모두 동일하게 입력해주세요.

• 요청 데이터 예시

1. 전체 갱신

해당 과제 혹은 시스템에 기존 등록되어 있던 차량은 삭제 되고, autonomousCarMaster 필드에 들어온 차량 정보가 등록됩니다. updateType 필드의 값과는 관계 없이 'I' (추가) 로 등록됩니다.

{
    "deltaUpdateFlag": "n",
    "autonomousCarMaster": [
        {
        "vehicleId": "12345",
        "serviceNo": "k5",
        "vehicleType": "G10",
        "maker": "MQNIC",
        "modelNm":"",
        "noplt":"",
        "updateType": "U",
        "updateDttm": "20250901155600"
        },
                {
        "vehicleId": "12346",
        "serviceNo": "k5",
        "vehicleType": "E10",
        "maker": "MQNIC",
        "modelNm":"",
        "noplt":"",
        "updateType": "I",
        "updateDttm": "20250901155600"
        }
    ]
}

1. 부분 갱신

해당 과제 혹은 시스템에 기존 등록되어 있던 차량과는 관계 없이, autonomousCarMaster 필드에 추가로 들어온 차량 정보가 갱신됩니다. updateType 을 참조하여 12345번 차량은 정보 업데이트, 12346번 차량은 삭제, 12347번 차량은 추가됩니다.

{
    "deltaUpdateFlag": "y",
    "autonomousCarMaster": [
        {
        "vehicleId": "12345",
        "serviceNo": "k5",
        "vehicleType": "E10",
        "maker": "MQNIC",
        "modelNm":"",
        "noplt":"",
        "updateType": "U",
        "updateDttm": "20250902155600"
        },
        {
        "vehicleId": "12346",
        "serviceNo": "k5",
        "vehicleType": "G10",
        "maker": "MQNIC",
        "modelNm":"",
        "noplt":"",
        "updateType": "D",
        "updateDttm": "20250902155600"
        },
       {
        "vehicleId": "12347",
        "serviceNo": "k5",
        "vehicleType": "Y10",
        "maker": "MQNIC",
        "modelNm":"",
        "noplt":"",
        "updateType": "I",
        "updateDttm": "20250902155600"
        }
    ]
}

참고사항

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

> POST /api/v1/acm/collect/pacm
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>

요청 예시

curl --location 'https://service.mqnicrnd5.com/api/v1/acm/collect/pacm' \
--header 'Authorization: Bearer <접근 토큰>' \
--header 'Content-Type: application/json' \
--data '{
    "deltaUpdateFlag": "n",
    "autonomousCarMaster": [
        {
            "vehicleId": "99371",
            "serviceNo": "k10",
            "vehicleType": "Y10",
            "maker": "",
            "modelNm":"",
            "noplt":"",
            "updateType": "I",
            "updateDttm": "20240617142040"
        }
    ]
}'

응답 파라미터

수집 API의 경우 별도 응답 파라미터가 아닌 HTTP Status Code로 성공 여부를 구분합니다.

Status Code	설명
200	성공
400	요청 파라미터 검증 실패
401	인증 실패
500	서버 오류

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

다음은 각 언어별 자율차마스터정보 수집 API 구현 예제입니다.

자율차마스터정보 수집 API (PostAutonomousCarMasterInfo)

Java

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;
import org.json.JSONObject; // JSON 라이브러리 추가 필요

public class CallAPI {

    public static void main(String[] args) {
        String accessToken = "Bearer <접근 토큰>"; // 실제 접근 토큰으로 교체 필요

        // JSON 객체 생성
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("deltaUpdateFlag", "y");
        
        // 'autonomousCarMaster' JSON 배열, 객체 생성 및 삽입
        JSONArray jsonArray = new JSONArray();
        
        JSONObject acm = new JSONObject();
        acm.put("vehicleId", "99371");
        acm.put("serviceNo", "10");
        acm.put("vehicleType", "");
        acm.put("maker", "");
        acm.put("updateType", "I");
        acm.put("updateDttm", "20240617142040");
        
        jsonArray.put(acm);
  
        // 위와 같이 jsonArray에 다른 자율차량 데이터들 추가
        
        jsonObject.put("autonomousCarMaster", jsonArray);
        
        String apiURL = "https://service.mqnicrnd5.com/api/v1/acm/collect/pacm"; // POST 요청 URL

        String responseBody = post(apiURL, jsonObject.toString(), accessToken);

        System.out.println(responseBody);
    }

    private static String post(String apiUrl, String jsonInputString, String accessToken) {
        HttpURLConnection con = connect(apiUrl);
        try {
            con.setRequestMethod("POST");
            con.setRequestProperty("Authorization", accessToken);
            con.setRequestProperty("Content-Type", "application/json; utf-8");
            con.setRequestProperty("Accept", "application/json");
            con.setDoOutput(true);

            try(OutputStream os = con.getOutputStream()) {
                byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8);
                os.write(input, 0, input.length);           
            }

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


    private static HttpURLConnection connect(String apiUrl) {
        try {
            URL url = new URL(apiUrl);
            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);
        }
    }
}

Python

Node.js

C#