๐จ๐ด RUNT โ VIN ์ฐจ๋ ํ์ธ
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/co/runt/vehicle-by-vin
vin ์ ์ฟผ๋ฆฌ๋ก ๋ณด๋ด ์ฝ๋กฌ๋น์ RUNT ์ ๋ฑ๋ก๋ ์ฐจ๋์ ์ ์ฒด ์ด๋ ฅยท๊ธฐ์ ๋ณด๊ณ ์๋ฅผ ์กฐํํฉ๋๋ค. ๋ฒํธํ์ด ์๊ฑฐ๋ ํ์ฅ ์ ๊ฒ ์ ์ฐจ๋ ๋ฒํธ๋ก ๋ณธ์ฐจ ์ฌ๋ถ๋ฅผ ํ์ธํ ๋ ์ ์ฉํฉ๋๋ค.
ํค๋(Headers)โ
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| name | type | required | description |
|---|---|---|---|
vin | string | yes | ์กฐํํ 17์๋ฆฌ VIN(๊ณต๋ฐฑ ์์, RUNT ๋ฑ๋ก ํ์). |
์์ฒญ(Request)โ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehicle-by-vin", {
params: { vin: "JTEBH9FJ7DK091425" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/runt/vehicle-by-vin"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"vin": "JTEBH9FJ7DK091425"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
์๋ต(Response)โ
- 200
- 404
- 409
{
"data": {
"informacionGeneral": {
"estadoDelVehiculo": "ACTIVO",
"marca": "TOYOTA",
"linea": "PRADO",
"modelo": "2013",
"noVin": "JTEBH9FJ7DK091425",
"noPlaca": "NET603",
"organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA"
},
"vin": "JTEBH9FJ7DK091425"
},
"signature": {
"message": "Certified by Verifik.co",
"dateTime": "October 10, 2025 8:12 PM"
},
"id": "BJ24Z"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing vin"
}
์ฐธ๊ณ (Notes)โ
- VIN ์ ์ฐจ๋๋น ๋ถ์ฌ๋ 17์๋ฆฌ ์๋ณ ๋ฒํธ์ ๋๋ค.
- ์๋ต์๋ ์ผ๋ฐ ์ ๋ณดยทSOATยท๊ฒ์ฌ ์ด๋ ฅ ๋ฑ RUNT ์์ ์ ๊ณต๋๋ ํ๋๊ฐ ํฌํจ๋ ์ ์์ต๋๋ค(๋ฐ์ดํฐ์ ๋ฐ๋ผ ๋ค๋ฆ).
ACTIVO๋ ๋ฑ๋ก์ด ์ ํจํ ์ํ์ ์์์ ๋๋ค.