카페24 자동차 부품몰
구축 제안서
고객이 차량번호를 입력하거나 차종을 직접 선택하면, 자사에서 판매하는 부품 중 해당 차량에 맞는 상품만 보여주는 쇼핑몰을 제안합니다. 카페24에서 상품·재고·결제·배송을 관리하고, 외부 중계 서버에서 차량 식별과 부품 호환 판정을 담당합니다. 운영자는 상품을 카페24에 한 번 등록한 뒤, 전용 관리자에서 그 상품에 맞는 차종과 적용 연식을 연결합니다.
- 구축 기간
- 8주 계약 후 · 카페24 활용안
- 제안 견적
- 1,000만 원 부가세 별도 · 외부 이용료 실비
- 제안일
- 2026.11.17 PC · 모바일 반응형
제안개요
차량 선택부터 구매까지 연결하고,
상품과 호환정보는 각 담당 화면에서 관리합니다.
고객내 차량에 맞는 판매 부품을 찾고, 카페24에서 주문·결제합니다.
운영자상품은 카페24에 등록하고, 전용 관리자에서 차종·연식·호환 조건을 연결합니다.
차량번호 기반 ‘내 차량 조회’는 카페24 로그인 회원에게 우선 제공합니다. 카페24의 공식 회원 인증 결과를 중계 서버에서 검증한 뒤 외부 차량 API를 호출합니다. 비로그인 차량번호 조회를 허용할 경우 중계 서버의 무단 호출과 반복 조회에 따른 비용 증가 등의 보안 문제가 발생할 수 있습니다. 비로그인 고객에게는 차종 직접 선택과 부품명·품번 검색을 제공합니다. 2차 대안으로 자체 몰 구축과 비로그인 차량 조회 허용안을 함께 제시합니다. 보안문제와 아키텍트 제안은 5절에 정리를 하였습니다.
| 결정할 항목 | 권장안 |
|---|---|
| 차량정보 조달 | 착수 즉시 공공데이터 API를 신청합니다. 민간 3사에도 같은 조건으로 견적과 테스트 자료를 요청해 공공 승인 지연이나 제원 부족에 대비합니다. |
| 쇼핑몰 디자인 | 자동차 부품몰 전용 반응형 커스텀 스킨을 제작합니다. carpartmall에서 검증한 차량 선택 흐름을 바탕으로 메인, 카테고리·검색 결과, 상품 상세를 설계합니다. 회원·장바구니·주문·결제는 카페24 표준 기능을 활용합니다. |
| 차량 조회 접근 정책 | 1차는 카페24 회원 인증을 검증한 사용자만 자동 차량 조회를 이용하도록 합니다. 2차 자체 몰에서는 공개 몰 서버와 사설 중계 서버를 분리하고, 비로그인 조회를 허용할 경우 IP·익명 세션·전체 호출량을 함께 제한합니다. |
| 8주 오픈의 전제 | 2주차에 핵심 화면 3종의 PC·모바일 시안과 오픈용 차량 조회 경로·테스트 일정을 확정하고, 고객사가 우선 판매 품목의 호환표를 검수합니다. 자동 조회나 PG 승인이 늦어질 때의 오픈 선택지는 7절에 명시했습니다. |
1. 간단한 데모페이지
데모페이지를 카페24 스킨에 적용해 고객의 차량 선택과 운영자의 호환표 편집을 시연했습니다. 다음 사례는 시연용 상품과 호환 데이터로 재현한 결과입니다. 카페24 데모페이지 미리보기
| 시연한 작업 | 확인한 결과 | 이번 구축에 적용할 내용 |
|---|---|---|
| 토요타 → RAV4 4세대 → 2016년식 선택 | 호환 샘플 부품 4개가 표시되고, ‘필터’ 분류를 누르면 오일필터·에어필터 2개로 좁혀집니다. 최근 선택한 차량 카드에서 같은 검색을 복원할 수 있습니다. | PC와 모바일에서 차량 선택을 유지한 채 카테고리·품번 검색과 상품 상세로 이동합니다. |
| 샘플 오일필터 한 개에 BMW 320i와 벤츠 C200 연결 | BMW에는 2015~2018년식, 벤츠에는 2016~2017년식을 각각 지정했습니다. 같은 2018년식이어도 BMW 검색에만 이 부품이 표시됩니다. | 같은 상품에 여러 차종과 서로 다른 적용 기간을 연결합니다. 연식 경계와 엔진별 예외를 검수 항목으로 사용합니다. |
| 카페24 상품관리와 화면 편집 | 샘플 부품 6종을 자체 상품코드로 등록하고, Easy 편집기에서 메인 문구·배너를 수정할 수 있게 구성했습니다. | 상품 정보는 카페24에서, 차종·품번·호환 조건은 전용 관리자에서 수정할 수 있도록 역할을 나눕니다. |
데모페이지의 VIN 조회는 예시 번호로 동작하고, 호환표 수정은 해당 브라우저에 저장됩니다. 이번 개발에서는 승인된 차량 API, 여러 운영자가 공유하는 DB, 카페24 상품 동기화를 연결합니다. 대량 검색 성능은 실제 납품 환경에서 측정합니다.
2. 경쟁 서비스
| 서비스 | 공개 화면 및 사전 조사 | 자사몰에 반영할 결정 |
|---|---|---|
| 파츠119(parts119) | 공개 화면에서 VIN·품번 검색과 차량 단계 선택을 제공합니다. 사전 조사에서는 VIN 입력 때마다 외부에서 해당 차량의 최신 규격 제원을 실시간 취득하는 방식은 아닌 것으로 파악했습니다. 공개 화면에서 원천 데이터의 조회 방식·갱신 주기까지 확인할 수는 없습니다. 파츠119 차량 검색 | VIN으로 찾은 차량 후보에 연식·엔진 정보를 표시합니다. 후보가 여러 개면 부품 규격을 나누는 조건만 고객에게 다시 묻습니다. |
| 부품나라 | 차량번호·소유주명·동의를 받고, 자동차등록원부 조회를 기웅정보통신에 위탁한다고 명시합니다. 의뢰사 사전 조사에서는 요청을 등록하고 배치 처리를 기다리는 흐름이 관찰됐습니다. 공개 자료로 확인되는 것은 위탁 관계이며, 처리 주기는 조사 당시의 관찰입니다. 부품나라 차량 조회·위탁 안내 | 차량 식별과 검증된 호환표가 준비된 경우 같은 화면에서 결과를 반환합니다. 외부 응답이 늦으면 차종 직접 선택을 즉시 제공합니다. 기웅 상품의 응답시간은 별도로 실측합니다. |
| Spareto | 상품 상세에서 순정 품번, 타사 대응 품번, 적용 차량과 대체 부품을 함께 확인할 수 있습니다. Spareto 브레이크 디스크 상세 | 국내 고객에게도 상품 상세의 ‘내 차 호환정보’ 탭에서 적용 조건과 순정·대체 품번을 함께 보여줍니다. |
3. 차량정보 API 도입 순서와 선정 기준
1순위 · 국토교통부 공공데이터 API 신청
쇼핑몰 운영사 명의로 자동차종합정보 첨부형 API를 신청합니다. 신청 목적은 ‘고객 본인 차량에 맞는 판매 부품 검색’으로 명시하고, 차대번호(VIN)·차명·모델연도·원동기형식·제원관리번호 등 필요한 항목을 지정합니다. 공식 첨부형 API 가이드의 개방항목에 차대번호가 포함돼 있으며, 실제 승인 항목과 샘플 응답에서 VIN 반환 형식·길이를 확인합니다. 운영사는 KCB 휴대폰 본인확인서비스에 가입하고 라이선스를 한국교통안전공단에 제출합니다. 개인 소유 차량의 고객은 몰에서 조회를 시작해 공단 인증창에서 차량등록번호·소유주명을 확인하고 휴대폰 본인확인과 제3자 제공 동의를 마칩니다. 중계 서버가 승인된 응답을 내부 차종 코드로 변환합니다. 포털상 데이터 이용료는 무료이며 본인확인·연계 비용은 별도입니다. 국토교통부 자동차종합정보 API · 자동차365 이용가이드 첨부 1
차량번호 조회로 차대번호(VIN)와 차량 제원을 함께 확보하는 흐름을 우선합니다. 공급사 응답에 포함된 VIN은 차량 식별에 활용하고, 차종 코드·모델연도·엔진 등 제원은 내부 차종 마스터와 호환표에 연결합니다. 부품별 장착 판정은 실제 반환 항목과 고객사가 검수한 호환 데이터로 수행합니다.
고객이 VIN을 직접 입력하는 검색창은 선정 API의 VIN 입력 지원 여부에 따라 연결합니다. 공급사가 VIN 직접 조회를 지원하면 해당 기능을 사용합니다. 대조 자료를 활용해야 할 경우에는 공공 ‘운행등록 전체차량’ 최근 분기 자료를 보조 후보로 검토합니다. 이 자료의 VIN은 뒤 6자리가 가려져 있으므로, 이용 승인을 받은 뒤 앞 11자리로 후보 차종을 찾고 엔진·트림을 추가 선택받습니다. 출고 옵션까지 필요한 상품은 해당 옵션 데이터의 확보 여부를 확인해 호환 판정에 반영합니다. 자동차365 이용가이드 첨부 2
2순위 · 유료 API 3사 비교 및 1개사 연동
| 후보 | 공개 자료에서 확인한 내용 | 이번 사업에서 검증할 점 |
|---|---|---|
| 쿠콘 | ‘소유자검증 차량정보 조회’로 차량 사양을 제공하며, ‘자동차 등록원부 통합 조회’의 제공 항목에는 차대번호가 명시돼 있습니다. 쿠콘 차량정보 활용 사례 · 등록원부 통합 조회 | 선택 상품에서 VIN·엔진·트림을 함께 받는 범위, 국산·수입차별 식별률, 월 기본료와 초과 호출료 |
| 나이스디앤알(NICE D&R) | Automotive Bureau에서 소유주명·차량번호 기반 등록원부와 신차 제원 데이터를 취급합니다. NICE D&R 자동차 데이터 | 계약 상품의 VIN 응답 필드·반환 범위, 두 데이터 사이의 연결 코드, 부품몰 이용권, 모델 변경 반영 주기 |
| 기웅정보통신 | ‘자동차 정보 조회’는 소유자명·차량번호로 차대번호(VIN), 차량 전산코드, 세부명칭, 연식, 구동방식, 연료, 변속기 등을 제공합니다. 등록원부 발급은 별도 상품입니다. 기웅정보통신 자동차 정보 조회 | VIN 반환 범위, 차량 전산코드와 자사 세부 차종의 대응률, 연식 경계·수입차 사양 정합성, 동기 응답시간과 재조회 보관 조건 |
민간 1차 실증 후보로는 쿠콘의 ‘자동차 정보 조회’를 권장합니다.
3사의 주요 기능은 대동소이하므로, 착수 시 실제 운영에 필요한 예상 사용량을 산정한 뒤 응답속도와 가격을 비교해 최종 공급사를 결정합니다. 예상 월 조회량을 기준으로 월 기본료·호출료·인증비를 비교하고, 동일한 조건에서 응답속도를 확인합니다.
3순위 · 자동차등록원부 스크래핑 개발 검토
앞의 두 방안이 요구 조건에 맞지 않을 때 검토할 수 있는 대안입니다. 열람·자동화가 허용되는 경로에서 자동차등록원부를 열람하고 PDF를 파싱해 필요한 차량정보를 추출하는 스크래핑 방식입니다.
별도로 구축하면 조회 화면, 인증 절차, PDF 양식 변경에 대응해야 하므로 유지관리 공수가 많이 필요하고 관리 포인트도 증가합니다.
조회 건수가 많지 않다면 별도 스크래핑 시스템을 구축·유지하는 것보다 API를 사용하는 것이 효율적입니다. 예상 조회량에 따른 API 이용료와 자체 구축·유지관리 비용을 비교해 도입 여부를 결정합니다.
4. 고객 화면과 운영자 업무
전용 스킨을 권장하는 이유는 고객이 상품을 고르는 순서에 있습니다. 상용 스킨을 활용하면 배너와 상품 진열을 빠르게 구성할 수 있습니다. 이 몰에서는 먼저 ‘내 차’를 고르고, 검색 결과에서 호환 부품을 좁힌 뒤, 상세에서 엔진·연식·장착 위치를 확인하고 구매합니다. 세 화면에 걸쳐 쓰이는 차량 선택 상태와 호환 표시를 처음부터 함께 설계하는 편이 적합합니다. 예를 들어 모바일에서 브레이크 패드를 찾을 때는 선택 차량을 결과 목록 상단에, 앞바퀴용·뒷바퀴용 구분을 상세의 구매 버튼 가까이에 표시합니다.
공통 헤더와 핵심 화면 3종은 카페24 스마트디자인에서 전용으로 제작합니다. 메인의 배너·문구는 Easy 기본 섹션으로 구성해 운영자가 직접 편집하고, 차량 검색 화면과 동작은 스킨 소스에서 관리합니다. 상품·가격은 카페24 상품관리에서, 적용 차종·연식은 전용 매핑 관리자에서 수정합니다. 카페24 Easy 섹션 편집 안내 · 커스텀 HTML 적용 안내
| 화면 | 구현 내용 |
|---|---|
| 메인·공통 상단 | PC·모바일에서 차량번호, VIN, 차종 직접 선택의 세 진입점을 제공합니다. 1차안의 ‘내 차량 조회’는 카페24 회원 인증 후 진행하며, 외부 차량 API를 호출하는 VIN 조회에도 같은 정책을 적용합니다. 비로그인 고객은 차종 직접 선택과 부품명·품번 검색을 이용합니다. 조회한 차량의 모델연도·엔진·구동 정보를 표시하고 다시 선택할 수 있게 합니다. 최근 차량 카드에는 고객이 선택한 차종·연식만 표시합니다. |
| 차종 선택·카테고리 | 제조사 → 모델·세대 → 모델연도 → 세부 트림·엔진 순으로 선택합니다. 차량을 바꾸기 전까지 카테고리, 부품명, 품번으로 결과를 좁혀도 선택 차량이 유지됩니다. 조회 실패·미지원 차량에도 직접 선택을 제공합니다. |
| 상품 상세 | ‘내 차 호환정보’ 탭에 적용 차종, 시작·종료 연식, 필요한 엔진·옵션 조건, 순정 품번(OE/OEM)과 OES·대체사 품번을 표시합니다. 장착 조건이 부족하면 ‘추가 확인 필요’와 확인할 항목을 표시합니다. |
| 품번 교차 검색 | 공백·하이픈·대소문자를 정규화해 원래 표기와 함께 보관합니다. 순정 품번 또는 대체사 품번을 검색하면 검증된 대응품을 제시하고, 선택 차량이 있으면 해당 차량의 적용 조건을 다시 확인합니다. |
| 주문·결제 | 카페24 회원가입, 로그인, 장바구니, PG 결제, 주문·배송 관리를 설정합니다. 기본 주문서에 ‘장착 확인용 차량번호 또는 차대번호’ 선택 항목을 두고, PC·모바일 주문 완료 후 담당자가 주문 상세에서 확인하는 과정까지 시험합니다. 카페24 주문서 추가항목 |
| 전용 매핑 관리자 | 제조사·모델·연식·트림을 트리에서 추가·수정·삭제합니다. 상품명·품번으로 상품을 찾아 호환 차종을 체크하고 적용 연식·엔진·예외 조건을 저장합니다. 적용 중인 차종을 삭제할 때는 연결된 상품을 표시해 해제 또는 대체하도록 합니다. |
| 초기 자료 적재·운영 | 고객사의 상품·호환표를 합의한 CSV 양식에 맞춰 가져옵니다. 미등록 품번, 중복 구간, 연식 역전, 식별 불가 행은 오류 목록으로 돌려주고 담당자가 확인한 행만 공개합니다. 누가 언제 어떤 연결을 바꿨는지 기록합니다. |
5. 카페24와 외부 중계 서버의 연동 구조
고객이 부품을 검색할 때마다 카페24 전체 상품을 읽으면 상품 수와 호출량이 함께 늘어납니다. 상품을 외부 검색 DB에 미리 동기화하고, 고객의 검색 요청은 차종과 연결된 상품번호만 읽도록 구성합니다. 차량정보 제공사는 최초 차량 식별에만 사용합니다. 같은 차로 필터·브레이크 등 분류를 바꿀 때는 외부 차량 API를 다시 호출할 필요가 없습니다.
운영자는 매핑 관리자로 호환표를 관리하고, 카페24 상품 변경은 검색 DB에 동기화합니다. 검색 결과의 상품을 선택하면 카페24 상세·장바구니·결제로 이어집니다.
기술 흐름도 소스 보기 (PlantUML)
@startuml
left to right direction
skinparam shadowing false
actor "고객 · PC / 모바일" as Customer
rectangle "카페24 스킨 · 차량 검색" as Storefront
rectangle "중계 서버\n차량 식별 / 호환 검색" as Middleware
rectangle "공공 또는 민간 차량 API" as VehicleAPI
database "차종 · 품번 · 호환표\n검색용 상품" as SearchDB
rectangle "운영자 · 매핑 관리자" as Admin
rectangle "카페24 상품관리" as ProductAdmin
rectangle "상품 동기화 작업" as ProductSync
rectangle "카페24 상품 상세\n장바구니 · 결제" as Commerce
Customer --> Storefront
Storefront --> Middleware
Middleware <--> VehicleAPI : 승인된 조회
Middleware <--> SearchDB : 차종·조건으로 검색
Admin --> Middleware
ProductAdmin --> ProductSync : 상품 변경 웹훅
ProductSync --> ProductAdmin : Admin API로 상품 조회
ProductSync --> SearchDB
Storefront --> Commerce : 검색 결과에서 상품 선택
@enduml
상품 동기화. 카페24의 상품번호(product_no)를 연결 키로 사용하고, 규격이 다른 옵션 상품은 품목 단위로 매핑합니다. 최초 적재는 상품번호 순으로 나누어 진행합니다. 이후 상품 변경 이벤트를 받으면 해당 상품을 다시 읽고, 정기 대사로 누락·삭제·판매중지 상태를 바로잡습니다. 호출 제한(429) 시 대기 후 재시도하고 중복 이벤트는 한 번만 반영합니다. 검색 목록은 판매·진열 가능한 상품만 반환하고 최종 옵션·가격·재고는 카페24 상세와 주문서 기준으로 확인합니다. 카페24 상품 목록 API · 웹훅 운영 가이드 · API 호출 제한
호환 판정. DB에는 ① 세부 차종 마스터(세대·엔진·구동 등), ② 공급사 차량 코드와 내부 차종 코드의 대응표, ③ 카페24 상품·품목, ④ 상품과 차종의 다대다(N:M) 호환표, ⑤ 브랜드별 순정·대체 품번 관계를 둡니다. 호환표 한 행에는 적용 모델연도 범위와 필요한 제작월·옵션·장착 위치를 기록합니다. 차종 코드·상품번호와 정규화 품번에 인덱스를 두고 결과를 페이지 단위로 읽습니다.
캐싱과 접근권한. 계약과 고객 동의가 허용한 항목·기간 안에서 동일 차량 재조회 결과를 중계 DB에 임시 보관합니다. 차량 식별 키는 서버 비밀키로 변환하고 조회 권한·동의 범위를 함께 확인합니다. 소유자명·차량번호·VIN 원문은 검색 로그에서 제외하고, 만료·철회 시 캐시를 삭제합니다. 보관이 허용되지 않는 공급사는 차종 마스터와 부품 검색 결과만 캐싱합니다. 카페24 OAuth 토큰과 차량 API 키는 서버에서 관리하며, 관리자 편집·조회 권한을 구분합니다. 카페24 API 인증 안내
5.1 중계 서버 분리 시 보안 문제와 권장 아키텍트
중계 서버는 차량 식별·호환 판정·호출 비용을 서버에서 관리하기 위해서입니다.
공개된 조회 주소에서 호출자의 인증·권한·사용량을 확인하지 않으면 무단 조회 경로가 생깁니다. 브라우저 개발자 도구에서 조회 주소와 요청 형식을 확인한 뒤, 쇼핑몰 화면을 거치지 않고 같은 요청을 반복할 수 있기 때문입니다.
이때 공격자는 외부 차량 API의 비밀키를 알 필요가 없습니다.
중계 서버가 요청을 그대로 받아 서버에 저장된 정상 키로 외부 API를 호출하면 조회 비용과 부하가 발생하며, API의 응답 범위에 따라 차량정보가 부적절하게 조회될 수 있습니다.
세 가지 구축 방식의 특징과 장단점
| 구성 | 특징 | 장점 | 단점·고려사항 |
|---|---|---|---|
| ① 카페24 프론트엔드와 중계 서버 분리 · 비로그인 조회 허용 | 카페24 스킨이 공개 중계 API를 호출합니다. 회원 로그인 없이 조회하며, 중계 서버에서 IP·익명 세션별 제한, 봇 검사, 전체 유료 호출 상한을 적용합니다. | 로그인 없이 바로 조회할 수 있어 이용 진입 장벽이 낮습니다. 구축 단계가 간단해집니다. | 중계 서버가 외부 공격에 노출됩니다. 정보 노출과 무단 반복 조회로 인한 비용 증가 위험이 있습니다. |
| ② 카페24 프론트엔드와 중계 서버 분리 · 로그인 회원만 조회 허용 | 카페24 OIDC 회원 인증 결과를 중계 서버가 검증하고 자체 세션을 발급합니다. 매 조회에서 세션·권한·회원별 한도·전체 호출 상한을 확인합니다. | 유효한 회원 인증이 없는 차량 조회를 외부 API 호출 전에 거절하여 외부의 무인증 조회 공격을 방어할 수 있습니다. 회원별 이용량 제한과 이력 관리가 가능합니다. | 고객에게 로그인과 필요한 동의 절차가 추가됩니다. OIDC·운영 도메인·세션 만료·로그아웃 연동 구현이 필요합니다. |
| ③ 자사몰 별도 구축 | 자체 몰의 공개 서버에서 로그인·조회 정책을 처리하고, 차량 조회 중계 서버는 사설망에서 몰 서버만 접근하도록 구성합니다. 로그인 전용 또는 비로그인 허용 정책을 직접 선택합니다. | 회원·조회 권한·세션·보안 정책을 통합 관리하고 차량 검색과 구매 흐름을 자유롭게 설계할 수 있습니다. 중계 서버를 외부의 직접 접근으로부터 보호할 수 있고, 비로그인 조회도 가능합니다. | 회원·상품·주문·결제·배송·관리자 기능의 구축이 필요합니다. |
권장안은 ② 카페24 로그인 회원 전용 구성입니다. 인증되지 않은 차량 조회를 차단하고, 회원별 이용량을 관리할 수 있습니다. 내 차량 조회의 비로그인 이용이 사업상 필수라면 ③ 자사몰 별도 구축안을 제안합니다.
카페24 앱 등록만으로 외부 중계 서버에 회원 인증이나 호출 제한이 자동 적용되지는 않습니다. 외부 서버의 접근 제어와 보안 서비스는 해당 서버의 운영 범위에 포함합니다. 아래는 호출자 검증을 생략했을 때의 위험 흐름입니다.

기술 흐름도 소스 보기 (PlantUML)
@startuml vehicle_lookup_01_public_risk
title 공개 중계 서버에서 호출자 검증을 생략한 경우
skinparam shadowing false
skinparam defaultFontName SansSerif
hide footbox
autonumber
actor "쇼핑몰 고객" as Customer
participant "카페24 스킨\n브라우저 JavaScript" as Skin
actor "인증되지 않은 호출자" as Caller
participant "공개 중계 서버" as Proxy
participant "외부 차량 API" as Provider
Customer -> Skin : 내 차량 조회
Skin -> Proxy : 차량번호·소유주명으로 요청
note over Skin,Proxy
조회 주소와 요청 형식은 브라우저에서 확인 가능
end note
Proxy -> Provider : 서버에 저장한 API 키로 조회
Provider --> Proxy : 차량 조회 결과
Proxy --> Skin : 결과 반환
loop 무인증 요청 반복
Caller -> Proxy : 쇼핑몰 화면 밖에서 같은 형식으로 요청
note right of Proxy
인증·권한·호출량 확인이 없으면
요청이 그대로 외부 API로 전달됨
end note
Proxy -> Provider : 정상 API 키를 붙여 대신 조회
Provider --> Proxy : 결과 반환 및 계약 기준 과금
Proxy --> Caller : 조회 결과 반환
end
note over Proxy,Provider
키 비공개만으로 무단 조회와 비용 발생을 막을 수 없음
end note
@enduml
5.2 1차 제안 카페24 로그인 회원만 차량 조회 허용
카페24의 쇼핑몰 회원 인증 기능인 Customer API의 OIDC를 연동합니다. 여기서 ‘인증정보 공유’는 카페24 비밀번호나 로그인 쿠키를 중계 서버에 복사한다는 뜻이 아닙니다. 카페24가 발급한 회원 인증 결과를 중계 서버가 검증하고, 검증된 회원에게 중계 서버용 세션을 발급하는 방식입니다. 상품 동기화를 위한 Admin API 권한과 고객의 회원 인증은 별도로 관리합니다.
커스텀 앱을 쇼핑몰에 설치·활성화하고 OIDC와 등록된 콜백 주소를 설정합니다. 고객이 ‘내 차량 조회’를 누르면 카페24의 공식 회원 인증 절차로 연결합니다. 기존 로그인 상태를 이용하되 필요한 경우 로그인과 최초 이용 동의를 받습니다. 중계 서버는 일회용 인증 코드를 카페24와 직접 교환하고, 인증 토큰의 서명·발급처·대상 앱·만료 및 인증 요청의 state·nonce를 검증합니다. 검증 후 확정한 쇼핑몰·회원 식별자를 세션과 이용량 집계에 사용하며, 브라우저가 임의로 보낸 회원번호나 로그인 여부는 신뢰하지 않습니다. 카페24 Customer API 회원 인증 가이드
중계 서버가 회원 인증 처리와 차량 조회를 함께 맡도록 구성하면 별도의 앱 서버를 추가하지 않아도 됩니다. 공용 앱 비밀키와 차량 API 키는 서버의 비밀 설정으로만 보관합니다. 브라우저에는 회원별 세션 증표만 전달하며, 쿠키 방식이라면 Secure·HttpOnly와 도메인에 맞는 SameSite 정책을 적용하고 조회 요청의 CSRF를 방어합니다. 카페24 스킨과 중계 서버 사이의 세션 전달은 실제 운영 도메인과 브라우저의 교차 사이트 쿠키 제한을 확인해 설계합니다.
매 조회에서 세션 유효성, 조회 권한·동의, 회원별 이용량과 전체 호출 상한을 먼저 확인합니다. 미인증·만료 요청은 401, 권한이 없는 요청은 403, 호출량 초과는 429 등 원인에 맞는 응답으로 거절하며 거절된 요청은 외부 차량 API로 전달하지 않습니다. 인증된 회원도 자신의 세션으로 반복 호출할 수 있으므로 회원별 제한은 계속 필요합니다. 회원 로그인은 차량 소유권을 증명하지 않으므로 공급사가 요구하는 본인확인·소유자 확인·동의 절차도 유지합니다.

기술 흐름도 소스 보기 (PlantUML)
@startuml vehicle_lookup_02_cafe24_member
title 1차안 카페24 회원 인증을 검증한 뒤 차량 조회
skinparam shadowing false
skinparam defaultFontName SansSerif
hide footbox
autonumber
actor "고객 브라우저\n카페24 스킨" as Browser
participant "카페24 회원 인증\nCustomer API OIDC" as Cafe24
participant "중계 서버\n인증 처리·차량 조회" as Proxy
participant "외부 차량 API" as Provider
Browser -> Proxy : 내 차량 조회 시작
Proxy --> Browser : state·nonce를 연계한 인증 URL
Browser -> Cafe24 : 공식 회원 인증 요청
Cafe24 -> Cafe24 : 기존 로그인 확인\n필요 시 로그인·최초 동의
Cafe24 --> Browser : 등록된 콜백으로 이동\n일회용 code·state
Browser -> Proxy : 인증 콜백
Proxy -> Proxy : state와 원래 인증 요청 대조
alt state 불일치
Proxy --> Browser : 인증 거절·코드 교환 중단
else state 일치
Proxy -> Cafe24 : 서버 간 코드 교환\n앱 client_secret 사용
Cafe24 --> Proxy : 서명된 ID 토큰 등 인증 결과
Proxy -> Proxy : 서명·발급처·대상 앱·만료·nonce 검증
alt 인증 검증 실패
Proxy --> Browser : 인증 거절·차량 API 호출 없음
else 인증 검증 성공
Proxy --> Browser : 해당 회원의 중계 서버 세션 발급
Browser -> Proxy : 세션을 포함한 차량 조회 요청
Proxy -> Proxy : 세션·권한·동의 검증\n회원별 한도·전체 호출 상한 확인
alt 검증 실패 또는 한도 초과
Proxy --> Browser : 조회 거절·차량 API 호출 없음
else 조회 허용
Proxy -> Provider : 서버에 보관한 차량 API 키로 조회
Provider --> Proxy : 승인된 차량정보
Proxy -> Proxy : 내부 차종·호환 부품 매핑
Proxy --> Browser : 해당 차량에 맞는 판매 부품
end
end
end
@enduml
카페24에서 로그아웃했다고 중계 서버 세션이 자동으로 종료된다고 가정하지 않습니다. 자체 세션 만료·로그아웃·재인증 정책을 별도로 구현하고, 운영 중 세션을 폐기할 수 있도록 합니다. 비로그인 고객과 인증에 실패한 고객은 차종 직접 선택·부품명·품번 검색으로 구매를 계속할 수 있습니다.
5.3 2차 제안 자체 몰과 사설 중계 서버 구축
회원·상품·주문·결제·관리자 기능을 자체 몰로 구축하면 로그인 세션과 차량 조회 권한을 같은 운영 체계에서 관리할 수 있습니다. 브라우저는 공개 몰 서버에만 요청하고, 차량 조회 중계 서버는 공인 진입점을 두지 않은 사설 네트워크에 배치하여 몰 서버만 접근하도록 구성합니다. 네트워크 접근 정책과 서버 간 인증을 함께 적용하고, 외부 차량 API에는 통제된 외부 통신 경로로 접속합니다. 외부에서는 중계 서버에 직접 연결할 수 없고, 몰 서버도 정해진 차량 조회 기능만 호출합니다.
자체 몰을 만들었다는 사실만으로 무단 조회가 해결되지는 않습니다. 공개 몰 서버가 요청을 무조건 전달하면 5.1의 문제가 반복됩니다. 따라서 몰 서버가 외부 차량 API 호출 전에 로그인 세션·조회 권한·동의·이용량을 검증하고, 중계 서버도 서버 간 인증과 전체 호출 상한을 확인하도록 설계합니다.
사용량이 많지 않다면 몰 서버와 차량 조회 중계 기능을 한 서버에 함께 구축하는 것도 가능합니다. 중계 기능을 몰 백엔드의 내부 모듈 또는 외부에서 직접 접근할 수 없는 로컬 서비스로 구성하면 초기 인프라 비용과 관리 부담을 줄일 수 있습니다. 이후 사용량이 증가하면 중계 서버를 분리해 확장할 수 있습니다.

기술 흐름도 소스 보기 (PlantUML)
@startuml vehicle_lookup_03_private_backend
title 2차안 자체 몰에서 사설 중계 서버 직접 접근 차단
skinparam shadowing false
skinparam defaultFontName SansSerif
hide footbox
autonumber
actor "고객 브라우저" as Browser
actor "외부 직접 호출자" as Caller
box "공개 진입점" #EAF2F8
participant "몰 서버\nWAF·요청 제한 적용" as Mall
end box
box "사설 네트워크" #EAF7EF
participant "접근 정책\n허용된 몰 서버만 통과" as Gate
participant "차량 조회 중계 서버" as Proxy
end box
participant "외부 차량 API" as Provider
Caller -> Gate : 중계 서버 직접 접근 시도
Gate --> Caller : 차단·외부 공개 경로 없음
Browser -> Mall : 로그인 세션을 포함한 차량 조회
Mall -> Mall : 세션·조회 권한·동의 확인\n회원별 제한·전체 호출 상한 확인
alt 미인증·권한 없음·한도 초과
Mall --> Browser : 조회 거절·중계 서버 호출 없음
else 조회 허용
Mall -> Gate : 사설망에서 내부 조회 요청
Gate -> Proxy : 허용된 몰 서버의 통신만 전달
Proxy -> Proxy : 서버 간 인증 검증\n허용된 작업·전체 호출 상한 확인
alt 내부 인증 실패 또는 상한 초과
Proxy --> Mall : 조회 거절·외부 API 호출 없음
Mall --> Browser : 이용 불가 안내
else 내부 검증 통과
Proxy -> Provider : 통제된 외부 통신 경로\n차량 API 키로 인증
Provider --> Proxy : 승인된 차량정보
Proxy --> Mall : 내부 차종·호환 부품 결과
Mall --> Browser : 해당 차량에 맞는 판매 부품
end
end
@enduml
자체 몰의 장점은 회원·권한·조회 이력·보안 정책을 통합하고 중계 서버의 직접 공개를 제거할 수 있다는 점입니다. 대신 회원 관리, 상품·재고, 주문·결제·취소·환불, 배송, 운영자 권한, 보안 업데이트와 장애 대응을 자체 구축·운영해야 합니다. 카페24 이전이 필요하면 상품·회원·주문 데이터의 이전 범위도 별도 설계합니다. 기존 8주·1,000만 원 제안은 카페24 활용안을 기준으로 하며, 자체 몰은 추가 대안으로 범위·일정·견적을 별도 산정합니다.
기술 스택과 선택 이유
| 계층 | 제안 기술 | 선택 이유 |
|---|---|---|
| 쇼핑몰 | 카페24 스마트디자인, 전용 반응형 HTML·CSS·JavaScript, Easy 콘텐츠 섹션 | 차량 선택 상태를 메인·검색 결과·상품 상세에서 공유하고 카페24의 상품 옵션·장바구니 모듈에 연결합니다. 운영자가 자주 바꾸는 배너·문구는 별도 섹션에 둡니다. |
| 중계·관리자 | TypeScript·Node.js(NestJS), React 관리자 | 공급사별 응답을 공통 차량 형식으로 변환합니다. 검색·저장 검증 규칙을 서버에서 일관되게 적용하고 관리자는 브라우저에서 운영합니다. |
| 데이터 | PostgreSQL | 다대다 관계, 연식 구간, 품번 인덱스와 변경 이력을 같은 DB에서 관리합니다. 일괄 반영 중 오류가 나면 해당 작업을 되돌릴 수 있습니다. |
| 인프라 | 고객사 AWS 계정의 애플리케이션 서버(EC2), 관리형 DB(RDS), CloudWatch | 중계 API는 쇼핑몰의 전용 서브도메인에 HTTPS로 연결하고 DB는 비공개 네트워크에 둡니다. 백업·복구 시험, 오류율·지연·동기화 실패 알림까지 구성합니다. |
6. 검수 기준과 오픈 후 성과 측정
| 항목 | 완료 확인 방법 |
|---|---|
| 커스텀 스킨·편집 | PC와 모바일에서 메인에서 고른 차량이 검색 결과와 상세에 동일하게 표시되고, 차량을 바꾸면 목록과 호환 표시가 함께 갱신되는지 확인합니다. 운영자가 Easy에서 배너·문구를 바꾸고 섹션 순서를 옮긴 뒤에도 검색과 구매가 동작해야 합니다. |
| 차량 식별 | 차량번호와 VIN의 표본을 나누고, 각 경로에서 실제 지원하는 차량의 정확한 식별률과 전체 표본의 미판정률을 측정합니다. 2주차에 경로별 최소 식별률을 합의합니다. VIN 일부가 같고 엔진이 다른 차량은 후보 선택으로, 미지원 차량은 수동 검색으로 이어져야 합니다. |
| 부품 정확도 | 고객사가 승인한 정답표로 연식 경계·엔진 차이·브랜드별 품번을 시험합니다. 확정 가능한 표본에서 기대한 호환 상품이 노출된 비율의 합격선을 2주차에 정하고, 비호환 정답 표본은 잘못된 ‘호환 확정’ 0건을 검수 기준으로 삼습니다. |
| 검색 성능 | 제안 시험 규모는 상품 1만 건·호환 연결 10만 건·동시 사용자 20명입니다. 중계 서버의 차종별 부품 검색은 요청 100건 중 95건이 0.5초 이내로 응답하는 것을 목표로 합니다. 첫 차량 조회는 본인확인·공급사 응답·내부 검색으로 나누어 실측합니다. 시험 규모와 기준은 1주차에 실제 자료량과 예상 트래픽으로 확정합니다. |
| 운영·장애 | 관리자가 한 상품을 두 차종에 연결하고 한쪽 연식을 수정한 뒤 다른 기기에서 결과를 확인합니다. 판매중지 상품 제외, API 시간 초과 시 수동 검색, 재조회 과금 방지, 캐시 만료, 웹훅 누락 후 복구를 시험합니다. |
| 1차 회원 인증·조회 차단 | 정상 카페24 회원의 인증 코드 교환·세션 발급 후 조회를 확인합니다. 위조 회원번호, 코드 재사용, state·nonce 불일치, 유효하지 않은 토큰, 세션 누락·만료·폐기 요청은 거절되고 외부 차량 API 호출 건수가 증가하지 않아야 합니다. 세션 만료·로그아웃·재인증과 실제 운영 도메인의 PC·모바일 동작을 함께 시험합니다. |
| 호출량·비용 제한 | 회원별·IP별 정책과 서비스 전체 상한에 맞춰 동시·반복 요청을 보내고, 초과분이 외부 차량 API로 전달되지 않는지 확인합니다. 과금되는 실패·재시도도 공급사 기준으로 집계하며, 한도 도달 시 안내·경보·차종 직접 선택이 동작해야 합니다. |
| 2차안 선택 시 추가 검수 | 인터넷에서 사설 중계 서버에 직접 연결할 수 없고, 허용되지 않은 서버·잘못된 내부 인증이 차단되는지 시험합니다. 비로그인 허용 시 IP 헤더 위조·원본 서버 우회·IP 변경·공유 IP·동시 요청을 확인하고, 개별 IP 제한을 우회해도 서비스 전체 호출 상한이 유지되어야 합니다. |
| 구매·운영 지표 | PC·모바일에서 검색 → 상세 → 장바구니 → PG 결제 → 주문 확인을 검수합니다. 오픈 후에는 ‘호환 불일치 취소·반품 건수 ÷ 주문 건수’와 ‘호환 검색 후 구매 세션 ÷ 호환 검색 세션’을 월별 비교합니다. 초기 운영 실적을 개선 기준선으로 삼습니다. |
7. 일정과 협업
파트너 선정 직후 착수하고, 수행사가 설계·개발·인프라·외부 연동을 총괄합니다. 고객사 전담자는 품번과 장착 조건을 검수하고, 임원진은 화면 시안과 API 계약을 승인합니다. 매주 작동 화면과 미결 사항을 함께 검토합니다.
| 기간 | 수행사 작업 | 고객사 준비·결정 / 주차별 확인 결과 |
|---|---|---|
| 1주 | 공공 API 신청 지원, 민간 견적·테스트 요청, 데이터 표본 분석. carpartmall 데모페이지로 차량 선택부터 구매까지의 화면 흐름 검토 | 카페24 계정·도메인 권한, 취급 부품·호환표·레퍼런스 인계. 로고·브랜드 자료 전달일과 PG 심사 일정 확인 |
| 2주 | 메인·검색 결과·상품 상세의 PC·모바일 시안과 ERD 설계. 차량·품번 표본 실증, 엔진·트림 누락 분석. 카페24 회원 OIDC·운영 도메인·세션 전달 실증 | 시안과 호환 판정 기준 승인. 공급사 승인 전망·견적 검토 후 우선 판매 품목과 오픈용 공급 경로 결정. 회원 전용 조회 정책과 호출량·비용 상한 확정 |
| 3~4주 | 공통 헤더·핵심 화면 3종의 반응형 스킨 제작, 차종 선택·품번 검색·카페24 상품 초기 동기화 개발 | 실제 취급 품목으로 PC·모바일 중간 시연. 고객사는 동명 차종·연식 경계에 대한 정답표 검수 |
| 5~6주 | 선정 API 연결, 카페24 회원 인증·세션 검증·호출 제한·캐싱, 매핑 관리자·CSV 적재, 상품 변경 동기화, 주문서·PG 설정 | 테스트 키와 운영계 발급 상태 점검. 실무자가 직접 호환표를 수정하고 시험 주문 확인. 미인증·한도 초과 요청의 외부 API 미호출 확인 |
| 7주 | 고객사 자료 적재, PC·모바일 통합 시험, 정확도·부하·장애 복구 검수 | 미매핑·오류 목록 정리, 우선 공개 상품과 수정 대상 확정 |
| 8주 | 운영계·도메인 연결, 실결제·취소 점검, 최종 배포, 소스 인계·관리자 교육 | 실무자·임원진 검수 후 오픈 승인 |
승인이 늦어질 경우 2주차에 공공 경로의 일정이나 필수 제원이 맞지 않으면, 테스트 결과와 계약 조건을 갖춘 민간 1개사로 전환하는 안을 제시합니다. 두 경로 모두 지연되면 고객사가 ① 자동 조회까지 포함한 오픈일 조정 또는 ② 차종·연식·품번 검색 우선 오픈 후 승인 시 자동 조회 추가 중에서 선택합니다. 후자를 선택해도 자동 조회의 개발·검수는 잔여 과업으로 관리합니다. PG 승인이 늦어지는 경우에는 검색·주문 테스트를 마친 후 결제 가능일에 맞춰 판매를 개시합니다.
8. 제안 견적과 납품물
| 구축 항목 | 제안 금액(부가세 별도) |
|---|---|
| 요구 분석, API 선정 지원, 화면·데이터 설계 | 100만 원 |
| 부품몰 전용 반응형 스킨 제작(공통 헤더, 메인, 카테고리·검색 결과, 상품 상세) | 200만 원 |
| 공공 또는 민간 차량정보 1개 공급 경로 연동, 인증·캐싱 | 150만 원 |
| 호환 검색 엔진, 품번 교차 검색, 카페24 상품 동기화 | 200만 원 |
| 전용 관리자, 제공 자료의 초기 적재·검증 | 200만 원 |
| 기본 커머스 세팅, AWS·도메인 배포, 통합 검수·교육 | 150만 원 |
| 합계 | 1,000만 원 |
1,000만 원은 carpartmall의 검증된 화면 흐름을 활용하고, 공통 헤더와 핵심 화면 3종을 맞춤 제작하는 기준의 제안 견적입니다. 회원·장바구니·주문·결제 화면은 카페24 표준 모듈과 주문서 추가항목 설정을 활용합니다. 차량번호 조회 공급 경로 1개 운영 연동, 승인된 자료를 이용한 VIN 후보 대조, 고객사 호환표의 초기 적재를 포함합니다. API·본인인증 이용료와 AWS·도메인·PG 비용은 고객사 계약에 따른 실비입니다. 별도 VIN 데이터 라이선스, 두 번째 실시간 공급사 연동, 원부 스크래핑, 추가 화면의 전면 재설계, 호환 근거가 없는 상품의 신규 조사·입력은 필요성이 확인되면 범위와 비용을 제시합니다.
| 인계 대상 | 납품 내용 |
|---|---|
| 카페24 쇼핑몰 | PC·모바일 전용 반응형 스킨 소스 일체(템플릿·스타일·스크립트), 차량 검색·상세 호환정보 탭, 카페24 적용 방법과 운영자용 배너·문구 편집 안내 |
| 중계 서버·전용 관리자 | 차량 연동, 상품 동기화, 호환·품번 검색, 매핑 관리자 웹의 소스코드 원본 일체, 배포·환경설정 예시와 운영계 인계 |
| 데이터·운영 문서 | 차종–부품 매핑 ERD와 테이블·필드 정의서, CSV 양식·오류 처리 방법, 연동 명세, 검수 결과, 백업 복구·장애 대응 안내, 관리자 실습 교육 |
| 보안 설계·운영 인계 | 선택한 구축안의 PlantUML 흐름도, 회원 인증·세션·로그아웃 정책, 비밀키 보관·교체 방법, 회원·IP·전체 호출 제한 설정, 비용 상한·경보·차단 해제 절차 |