CDK 드라이브 서비스 차량(미리 보기)
CDK 드라이브 서비스 차량은 차량에 대한 식별, 유형, 상태 및 고객 정보를 연결합니다. API를 사용하면 CDK에서 서비스 도메인 차량 정보를 만들고, 업데이트하고, 쿼리하고, 검색할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | CDK Global |
| URL | https://serviceconnect.support.cdk.com |
| 전자 메일 | mbd_support@cdk.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | CDK Global |
| 웹 사이트 | https://fortellis.io |
| 개인 정보 보호 정책 | https://fortellis.io/privacy |
| 카테고리 | 데이터 |
CDK 드라이브 - 서비스 - 차량 관련 차량 식별, 유형, 상태 및 차량에 대한 고객 정보입니다.
이 API는 무엇을 합니까? API를 사용하면 CDK 드라이브에서 서비스 도메인 차량 정보를 만들고, 업데이트하고, 쿼리하고, 검색할 수 있습니다.
대상 그룹 차량은 서비스 약속 및 서비스 복구 주문 워크플로에 대한 종속성입니다.
Pre-requisites
계속하려면 다음이 필요합니다.
• 커넥터를 사용하려면 Fortellis 사용자여야 합니다.
• API를 호출하는 동안 사용할 클라이언트 ID 및 비밀을 생성하기 위해 Fortellis에서 솔루션을 만들어야 합니다.
잠재적 사용 사례
CDKDrive 서비스 차량 API를 사용하여 다음과 같은 상황을 처리하는 솔루션을 만듭니다.
- 서비스 차량 정보 만들기 또는 업데이트
- 서비스 차량에 고객 연결
- ID 또는 필터 기준으로 기존 서비스 차량 검색
자세한 설명서는 다음에서 찾을 수 있습니다.
https://apidocs.fortellis.io/specs/54b70ee1-ac17-4be2-9314-45c947692c5d
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 식별자별 차량 쿼리 |
식별자별 차량 쿼리 |
| 차량 만들기 |
차량 만들기 |
| 차량 업데이트 |
차량 업데이트 |
| 차량 쿼리 |
차량 쿼리 |
식별자별 차량 쿼리
식별자별 차량 쿼리
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
차량 ID
|
vehicleId | True | string |
차량 식별자 |
|
구독 ID
|
subscription_id | True | string |
지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다. |
|
클라이언트 ID
|
client_id | True | string |
솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다. |
|
클라이언트 암호
|
client_secret | True | string |
솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다. |
|
요청 ID
|
Request-Id | string |
형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다. |
반환
- 몸
- Vehicle
차량 만들기
차량 만들기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
클라이언트 ID
|
client_id | True | string |
솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다. |
|
클라이언트 암호
|
client_secret | True | string |
솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다. |
|
구독 ID
|
subscription_id | True | string |
지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다. |
|
요청 ID
|
Request-Id | True | string |
형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다. |
|
빈 (vin)
|
vin | string |
차량 부인 번호 |
|
|
licensePlateNum
|
licensePlateNum | string |
차량 번호판 번호 |
|
|
makeCode
|
makeCode | True | string |
차량에서 코드를 만듭니다. |
|
만들다
|
make | string |
차량 이름 지정 |
|
|
modelCode
|
modelCode | True | string |
차량 모델 코드 |
|
model
|
model | string |
차량 모델 이름 |
|
|
modelYear
|
modelYear | True | number |
차량 모델 연도 |
|
exteriorColor
|
exteriorColor | string |
차량 외부 색 |
|
|
value
|
value | True | number |
측정값 |
|
단위
|
units | True | string |
측정 단위 |
|
status
|
status | True | string |
차량의 상태가 신규, 사용 또는 인증되었나요? |
|
배달
|
delivered | True | date |
RFC 3339, 섹션 5.6에 정의된 대로 현재 소유자에게 차량의 배달 날짜(예: 2017-07-21) |
|
inService
|
inService | True | date |
RFC 3339, 섹션 5.6에 정의된 원래 소유자에 대한 소매 판매 날짜(예: 2017-07-21) |
|
warrantyExpiration
|
warrantyExpiration | date |
RFC 3339, 섹션 5.6에 정의된 차량의 보증 만료 날짜(예: 2017-07-21) |
|
|
ownerHref
|
ownerHref | string |
소유자 고객 리소스에 대한 하이퍼링크 |
|
|
primaryDriverHref
|
primaryDriverHref | string |
기본 드라이버 고객 리소스에 대한 하이퍼링크 |
반환
- 몸
- Vehicle
차량 업데이트
차량 업데이트
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
차량 ID
|
vehicleId | True | string |
차량 식별자 |
|
구독 ID
|
subscription_id | True | string |
지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다. |
|
클라이언트 ID
|
client_id | True | string |
솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다. |
|
클라이언트 암호
|
client_secret | True | string |
솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다. |
|
요청 ID
|
Request-Id | string |
형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다. |
|
|
eTag 값
|
If-Match | True | string |
리소스 업데이트 요청을 조건부로 만듭니다. If-Match 제공된 체크섬 값은 리소스의 현재 ETag 값과 일치해야 합니다. |
|
빈 (vin)
|
vin | string |
차량 부인 번호 |
|
|
licensePlateNum
|
licensePlateNum | string |
차량 번호판 번호 |
|
|
makeCode
|
makeCode | True | string |
차량에서 코드를 만듭니다. |
|
만들다
|
make | string |
차량 이름 지정 |
|
|
modelCode
|
modelCode | True | string |
차량 모델 코드 |
|
model
|
model | string |
차량 모델 이름 |
|
|
modelYear
|
modelYear | True | number |
차량 모델 연도 |
|
exteriorColor
|
exteriorColor | string |
차량 외부 색 |
|
|
value
|
value | True | number |
측정값 |
|
단위
|
units | True | string |
측정 단위 |
|
status
|
status | True | string |
차량의 상태가 신규, 사용 또는 인증되었나요? |
|
배달
|
delivered | True | date |
RFC 3339, 섹션 5.6에 정의된 대로 현재 소유자에게 차량의 배달 날짜(예: 2017-07-21) |
|
inService
|
inService | True | date |
RFC 3339, 섹션 5.6에 정의된 원래 소유자에 대한 소매 판매 날짜(예: 2017-07-21) |
|
warrantyExpiration
|
warrantyExpiration | date |
RFC 3339, 섹션 5.6에 정의된 차량의 보증 만료 날짜(예: 2017-07-21) |
|
|
ownerHref
|
ownerHref | string |
소유자 고객 리소스에 대한 하이퍼링크 |
|
|
primaryDriverHref
|
primaryDriverHref | string |
기본 드라이버 고객 리소스에 대한 하이퍼링크 |
반환
- 몸
- Vehicle
차량 쿼리
차량 쿼리
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
빈 (Vin)
|
vin | string |
VIN으로 차량 필터링 |
|
|
번호판 번호
|
licensePlateNum | string |
번호판 번호로 차량 필터링 |
|
|
고객 ID
|
customerId | string |
customerId로 차량 필터링 |
|
|
구독 ID
|
subscription_id | True | string |
지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다. |
|
클라이언트 ID
|
client_id | True | string |
솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다. |
|
클라이언트 암호
|
client_secret | True | string |
솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다. |
|
요청 ID
|
Request-Id | string |
형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다. |
반환
정의
차
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
vehicleId
|
vehicleId | string |
차량 레코드의 idenifier |
|
신분 증명
|
identification | VehicleIdentification |
차량 식별. 엔터티가 유효하려면 ID 속성 중 하나 이상을 정의해야 합니다. |
|
사양
|
specification | VehicleSpecification | |
|
exteriorColor
|
exteriorColor | string |
차량 외부 색 |
|
마일리지
|
mileage | Measurement | |
|
status
|
status | string |
차량의 상태가 신규, 사용 또는 인증되었나요? |
|
날짜
|
dates | Dates | |
|
ownerHref
|
ownerHref | string |
소유자 고객 리소스에 대한 하이퍼링크 |
|
primaryDriverHref
|
primaryDriverHref | string |
기본 드라이버 고객 리소스에 대한 하이퍼링크 |
|
links
|
links | VehicleLinks |
VehicleIdentification
차량 식별. 엔터티가 유효하려면 ID 속성 중 하나 이상을 정의해야 합니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
빈 (vin)
|
vin | string |
차량 부인 번호 |
|
licensePlateNum
|
licensePlateNum | string |
차량 번호판 번호 |
VehicleLinks
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
리소스에 대한 링크의 세부 정보
|
self | LinkDescriptionObject |
VehicleCollection
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
items
|
items | array of Vehicle |
VehicleSpecification
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
makeCode
|
makeCode | string |
차량에서 코드를 만듭니다. |
|
만들다
|
make | string |
차량 이름 지정 |
|
modelCode
|
modelCode | string |
차량 모델 코드 |
|
model
|
model | string |
차량 모델 이름 |
|
modelYear
|
modelYear | number |
차량 모델 연도 |
측정
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | number |
측정값 |
|
단위
|
units | string |
측정 단위 |
날짜
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
배달
|
delivered | date |
RFC 3339, 섹션 5.6에 정의된 대로 현재 소유자에게 차량의 배달 날짜(예: 2017-07-21) |
|
inService
|
inService | date |
RFC 3339, 섹션 5.6에 정의된 원래 소유자에 대한 소매 판매 날짜(예: 2017-07-21) |
|
warrantyExpiration
|
warrantyExpiration | date |
RFC 3339, 섹션 5.6에 정의된 차량의 보증 만료 날짜(예: 2017-07-21) |
LinkDescriptionObject
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
href
|
href | string |
대상 URI |
|
method
|
method | string |
링크 대상에 대한 요청을 만드는 데 사용해야 하는 HTTP 동사입니다. |
|
title
|
title | string |
타이틀 속성은 링크에 대한 제목을 제공하며 최종 클라이언트의 이해를 용이하게 하는 유용한 설명서 도구입니다. |