๐ฆ๐ท ์๋ฅดํจํฐ๋ โ ์ฐจ๋ v3
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v3/ar/vehicle
์ด ์๋ํฌ์ธํธ๋ฅผ ์ฌ์ฉํ์ฌ ๋ฒํธํ์ผ๋ก ์๋ฅดํจํฐ๋ ์ฐจ๋ ์์ธ ์ ๋ณด๋ฅผ ์กฐํํฉ๋๋ค. ์๋ต์๋ ์์ง ๋ฒํธ, ์์, ๋ธ๋๋, ๋ชจ๋ธ, ์ฐ์, ์์, ์ฐจ๋ ์ ํ, ํ์ฑ ๋ณดํ ์ํ ๋ฐ ๊ธฐ์ ์ํธ ํ๋(๊ฐ๋ฅํ ๊ฒฝ์ฐ)๊ฐ ํฌํจ๋ฉ๋๋ค.
ํค๋โ
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์โ
| ์ด๋ฆ | ์ ํ | ํ์ | ์ค๋ช |
|---|---|---|---|
plate | string | Yes | ๋ฉ๋ฅด์ฝ์๋ฅด ํ์ AA-123-BB (AA123BB๋ก ์ ์ก, ๊ณต๋ฐฑ ๋ฐ ๊ตฌ๋์ ์์). |
์์ฒญโ
- JavaScript
- Python
import axios from 'axios';
const { data } = await axios.get('https://api.verifik.co/v3/ar/vehicle', {
params: { plate: 'AA123BB' },
headers: {
Accept: 'application/json',
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os
import requests
url = "https://api.verifik.co/v3/ar/vehicle"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"plate": "AA123BB"}
response = requests.get(url, headers=headers, params=params)
print(response.json())
์๋ตโ
- 200
- 404
- 409
- 500
{
"data": {
"brand": "TOYOTA",
"chassis": "AR10000001CH",
"color": "BLANCO",
"engineNumber": "AR10000001M",
"isActivePolicyFound": false,
"model": "COROLLA 2020",
"modelGroup": "COROLLA",
"plate": "AA123BB",
"technicalSheet": {
"engine": {
"engineDescription": "1.6L",
"fuel": "NAFTA",
"powerHp": "110"
},
"performance": {
"cityConsumption": "10 km/L",
"highwayConsumption": "14 km/L"
},
"dimensions": {
"doors": "4",
"occupants": "5"
}
},
"type": "AUTOMOVIL",
"year": "2020"
},
"signature": {
"dateTime": "July 1, 2026 10:00 AM",
"message": "Certified by Verifik.co"
}
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing plate\n"
}
{
"code": "InternalServerError",
"message": "Server error."
}
์๋ต ํ๋โ
| ํ๋ | ์ ํ | ์ค๋ช |
|---|---|---|
plate | string | ์ ๊ทํ๋ ์ฐจ๋ ๋ฒํธํ. |
engineNumber | string | null | ์์ค์์ ๋ฐํ๋ ์์ง ๋ฒํธ. |
chassis | string | null | ์์ค์์ ๋ฐํ๋ ์์ ์๋ณ์. |
year | string | null | ์ฐจ๋ ์ฐ์. |
brand | string | null | ์ฐจ๋ ๋ธ๋๋. |
modelGroup | string | null | ๋ชจ๋ธ๊ตฐ. |
model | string | null | ๋ชจ๋ธ/๋ฒ์ ๋ผ๋ฒจ. |
color | string | null | ๋ฑ๋ก ์์. |
type | string | null | ์ฐจ๋ ์ ํ. |
isActivePolicyFound | boolean | ํ์ฑ ๋ณดํ์ด ๋ฐ๊ฒฌ๋์๋์ง ์ฌ๋ถ. |
technicalSheet | object | null | ๊ฐ๋ฅํ ๊ฒฝ์ฐ ๊ธฐ์ ์ํธ ๋ฐ์ดํฐ. |
์ฐธ๊ณ โ
- ์ผ์นํ๋ ๊ธฐ์ ๋ฐ์ดํฐ๊ฐ ์์ผ๋ฉด
technicalSheet๋null์ด๊ฑฐ๋ ๋ถ๋ถ์ ์ผ๋ก ์ฑ์์ง ์ ์์ต๋๋ค. - ์๋น์ค๋ ์์ค๋ฅผ ์กฐํํ๊ธฐ ์ ์ ๋ฒํธํ ๋์๋ฌธ์๋ฅผ ์ ๊ทํํฉ๋๋ค.