{"openapi":"3.0.3","info":{"title":"APICK 운전·차량 행정 통합 조회","version":"1.0.0","description":"본인 간편인증 후 경찰청·행정안전부의 운전·차량 행정 통합 조회 자료를 확인합니다. 이름: 면허 소지자 이름 주소: 면허에 등록된 주소 면허번호: 운전면허번호 관할경찰서: 면허를 관리하는 경찰서"},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/req_license_bundle":{"post":{"summary":"운전·차량 행정 통합 조회","description":"본인 간편인증 후 경찰청·행정안전부의 운전·차량 행정 통합 조회 자료를 확인합니다. 이름: 면허 소지자 이름 주소: 면허에 등록된 주소 면허번호: 운전면허번호 관할경찰서: 면허를 관리하는 경찰서","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","description":"결과 스키마 버전 (고정값: \"1.0\")"},"transactionId":{"type":"string","description":"결과 조회에 사용하는 트랜잭션 ID"},"product":{"type":"string","description":"조회 항목 코드. 결과조회에도 같은 값이 오므로 어느 항목의 결과인지 대조할 수 있습니다."},"status":{"type":"string","description":"처리 상태 (AUTH_REQUESTED: 인증 요청 완료)"},"resultAvailable":{"type":"boolean","description":"결과 데이터 포함 여부. 인증 요청 응답은 항상 false 입니다."},"charged":{"type":"boolean","description":"이번 호출의 과금 발생 여부. 실제 발송에 성공하면 true 입니다."},"sources":{"type":"array","items":{}},"message":{"type":"string","description":"상태 메시지 (고정값: \"인증 대기중입니다.\")"},"expiresAt":{"type":"string","description":"인증 유효 기한(ISO 8601). 이 시각까지 승인하지 못하면 인증 실패 처리됩니다."},"success":{"type":"integer","description":"과금 여부0: 실패 또는 재사용(무과금)1: 발송 성공(과금)"},"approvals":{"type":"integer","description":"필요한 간편인증 승인 횟수. 조회 항목 하나당 1회입니다."}},"description":"인증 요청 결과"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"이름 (string)","example":"홍길동"},"birthDate":{"type":"string","description":"생년월일 8자리(YYYYMMDD) (string)","example":"19900101"},"phone":{"type":"string","description":"휴대전화 번호 (본인 명의, 숫자만) (string)","example":"01011112222"},"authProvider":{"type":"string","description":"간편인증 방식 (아래 지원 목록 참고) (string)","example":"kakao"}},"required":["name","birthDate","phone","authProvider"]}}}}}},"/rest/get_license_bundle":{"post":{"summary":"운전·차량 행정 통합 조회","description":"본인 간편인증 후 경찰청·행정안전부의 운전·차량 행정 통합 조회 자료를 확인합니다. 이름: 면허 소지자 이름 주소: 면허에 등록된 주소 면허번호: 운전면허번호 관할경찰서: 면허를 관리하는 경찰서","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","description":"결과 스키마 버전 (고정값: \"1.0\")"},"transactionId":{"type":"string","description":"트랜잭션 ID"},"product":{"type":"string","description":"조회 항목 코드. 인증요청 응답과 같은 값입니다."},"status":{"type":"string","description":"처리 상태 (위 표 참고)"},"resultAvailable":{"type":"boolean","description":"실제 결과 포함 여부. 과금 여부도 이 값으로 결정됩니다."},"charged":{"type":"boolean","description":"이번 호출의 과금 발생 여부. 최초 결과 반환에서만 true 입니다."},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"}}},"description":"항상 포함됩니다. 값이 없으면 빈 배열 [] 입니다. 항목이 여러 개인 상품에서 어느 것이 성공·실패했는지 알려줍니다. 각 항목은 source(제공 기관명), type(데이터 종류), status(SUCCESS/FAILED). 수집이 끝나기 전에는 아직 확정되지 않은 기관이 FAILED 로 보일 수 있습니다."},"message":{"type":"string","description":"상태 메시지"},"expiresAt":{"type":"string"},"success":{"type":"integer","description":"과금 여부0: 결과 없음 또는 재조회(무과금)1: 최초 결과 반환(과금)"},"progress":{"type":"object","properties":{"total":{"type":"integer"},"completed":{"type":"integer"}},"description":"진행률(COLLECTING 일 때). total(전체 항목), completed(완료 항목)"},"checkedAt":{"type":"string","description":"실제 정보를 확인한 시각. 한국시간(UTC+09:00) ISO 8601 이며 재조회 유효기간의 기준입니다."},"resultExpiresAt":{"type":"string","description":"결과 재조회 만료 시각. 한국시간(UTC+09:00) ISO 8601 입니다."},"result":{"type":"object","properties":{"drivingLicense":{"type":"object","additionalProperties":true,"properties":{"이름":{"type":"string","description":"면허 소지자 이름"},"주소":{"type":"string","description":"면허에 등록된 주소"},"면허번호":{"type":"string","description":"운전면허번호"},"관할경찰서":{"type":"string","description":"면허를 관리하는 경찰서"},"국적":{"type":"string","description":"국적"},"면허상태":{"type":"string","description":"면허 상태 표기"},"취소일자":{"type":"string","description":"취소 처분을 받은 날. 정상이면 빈 값이다."},"적성검사일자":{"type":"string","description":"적성검사를 받은 날"},"적성검사기관":{"type":"string","description":"적성검사를 시행한 기관"},"적성검사유효기간":{"type":"string","description":"적성검사 유효기간 표기. 사람이 읽는 문자열이며 날짜 형식이 아니다."},"적성검사시작":{"type":"string","description":"적성검사 대상 기간 시작"},"적성검사종료":{"type":"string","description":"적성검사 대상 기간 종료"},"정지기간":{"type":"string","description":"정지 처분 기간. 정지가 없으면 빈 값이다."},"정지사유":{"type":"string","description":"정지 사유. 정지가 없으면 빈 값이다."},"재교부일자":{"type":"string","description":"재교부받은 날. 이력이 없으면 빈 값이다."},"재교부사유":{"type":"string","description":"재교부 사유. 이력이 없으면 빈 값이다."},"subList":{"type":"array","description":"이전 형식의 면허 취득 부가항목. 구성과 값 타입은 가변적이며 신규 연동은 취득이력을 사용하세요.","items":{"type":"object"}},"취득이력":{"type":"array","description":"면허 종류별 취득 이력. 없으면 빈 배열이다.","items":{"type":"object","properties":{"면허종류코드":{"type":"string","description":"면허 종류 코드"},"발급일자":{"type":"string","description":"면허 발급일"},"합격일자":{"type":"string","description":"시험 합격일"},"발급지역":{"type":"string","description":"발급 지역"},"발급일련번호":{"type":"string","description":"발급 일련번호"},"학원명":{"type":"string","description":"운전학원명. 학원을 다니지 않았으면 빈 값이다."},"졸업일자":{"type":"string","description":"학원 졸업일"},"공고시험장":{"type":"string","description":"시험을 본 시험장"},"등록일자":{"type":"string","description":"학원 등록일"},"면허조건":{"type":"string","description":"면허 조건 코드"}}}},"조회결과":{"type":"string","description":"대상이 없을 때 조회결과만 \"대상 없음\" 으로 온다. 이때 위 항목은 담기지 않는다."}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"policePenalty":{"type":"object","properties":{"건수":{"type":"integer","description":"납부한 과태료·범칙금 건수"},"납부내역":{"type":"object","items":{"type":"object","properties":{"납부일자":{"type":"string"},"기관명":{"type":"string"},"위반내용":{"type":"string"},"납부금액":{"type":"string"},"전자납부번호":{"type":"string"}}},"description":"납부 항목 전체. 기관이 항목 이름을 정하므로 아래는 실제로 오는 대표 항목이다.","properties":{"납부일자":{"type":"string","description":"납부일 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."},"기관명":{"type":"string","description":"부과 기관 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."},"위반내용":{"type":"string","description":"위반 내용 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."},"납부금액":{"type":"string","description":"납부 금액. 원 단위 금액이 문자열로 온다. 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."},"전자납부번호":{"type":"string","description":"전자납부번호 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"parkingFineTarget":{"type":"object","properties":{"조회결과":{"type":"string","description":"납부 대상이 없으면 \"납부 대상 없음\", 있으면 \"확인됨\"."},"건수":{"type":"integer","description":"납부 대상 건수. 대상이 없으면 0 이다."},"납부대상":{"type":"object","items":{"type":"object","properties":{"고지번호":{"type":"string"},"차량번호":{"type":"string"},"위반일시":{"type":"string"},"위반장소":{"type":"string"},"납부금액":{"type":"string"},"납부기한":{"type":"string"}}},"description":"납부 대상 항목. 기관이 항목 이름을 정하므로 아래는 실제로 오는 대표 항목이다.","properties":{"고지번호":{"type":"string","description":"고지 번호 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."},"차량번호":{"type":"string","description":"차량 번호 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."},"위반일시":{"type":"string","description":"주정차 위반 일시 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."},"위반장소":{"type":"string","description":"위반 장소 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."},"납부금액":{"type":"string","description":"납부 금액.원 단위 금액이 숫자가 아닌 문자열로 온다. 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."},"납부기한":{"type":"string","description":"납부 기한 대표 항목이며 자료에 따라 이름·값 타입이 다르고 생략되거나 추가될 수 있습니다."}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."}},"description":"조회된 결과 묶음. 실제 데이터가 있을 때만 포함됩니다."},"errorCode":{"type":"string","description":"오류 구분. RESULT_EXPIRED(재조회 기간 만료) / AUTH_EXPIRED / AUTH_REJECTED / COLLECT_FAILED"}},"description":"상태·결과"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"transactionId":{"type":"string","description":"/rest/req_license_bundle 가 반환한 트랜잭션 ID (string)","example":"9f2c4a7b1d8e35c60a4f7b2d1e9c803a"}},"required":["transactionId"]}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}