๐จ๐ด ๋ณด๊ณ ํ โ ํผ์ฝ์ดํ๋ผ์นด
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/co/vehiculo/pico-y-placa
๋ณด๊ณ ํ์ ๋ฑ๋ก๋ ์ฐจ๋์ ํผ์ฝ ์ด ํ๋ผ์นด(๋ฒํธํ ๋์๋ฆฌ ํตํ ์ ํ) ์ค์๊ฐ ์ ๋ณด๋ฅผ ์กฐํํฉ๋๋ค. ์กฐํํ plate ์ ์์ธ(์ฅ์ ๋ฑ ์น์ธ๋ ๋ฉด์ )๊ฐ ์์ผ๋ฉด ์๋ต์ ํฌํจ๋ ์ ์์ต๋๋ค.
ํค๋(Headers)โ
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| name | type | required | description |
|---|---|---|---|
plate | string | yes | ์กฐํํ ๋ฒํธํ(๊ณต๋ฐฑ ์์ยท๋ณด๊ณ ํ ํ์). |
์์ฒญ(Request)โ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/vehiculo/pico-y-placa", {
params: { plate: "ABC123" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/vehiculo/pico-y-placa"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"plate": "ABC123"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
์๋ต(Response)โ
- 200
- 404
- 409
{
"data": {
"placa": "ABC123",
"causalExcepcion": "Discapacidad - Documento #: 12345678",
"activoDesde": "16-06-2022 07:00:28 PM",
"estado": "ACTIVO",
"detalles": {
"informaciรณnDeLaExcepcion": [
"Tipo Excepciรณn: Discapacidad",
"Descripciรณn: vehiculos de personas con discapacidad.Automotores que transporten o sean conducidos por personas con discapacidad permanente, cuya condiciรณn motora, sensorial o mental limite su movilidad, siempre y cuando cumplan las normas establecidas.",
"Fecha Registro: 16-06-2022 05:25:29 PM"
],
"observaciones": [
"Informaciรณn validada ante en RUNT. "
],
"informaciรณnDeLaPersonaEnCondicionDeDiscapacidad": [
"Nombres: MATEO VERIFIK",
"No. Documento: 1112345678"
],
"informaciรณnDelvehiculo": [
"Placa: EHO820",
"ACTIVO"
]
}
},
"signature": {"message": "Certified by Verifik.co", "dateTime": "August 23, 2022 10:55 AM"}
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing plate"
}
์ฐธ๊ณ (Notes)โ
- ๋ณด๊ณ ํ ๋ฑ๋ก ์ฐจ๋๋ง ํด๋นํฉ๋๋ค.
- ์ ํ์ ๋ฒํธํ ๋์๋ฆฌ๋ฅผ ๊ธฐ์ค์ผ๋ก ํฉ๋๋ค.
- ํน๋ณ ํ๊ฐ(์ฅ์ ยท๊ธด๊ธ ๋ฑ)๊ฐ ์์ผ๋ฉด ์์ธ๋ก ๋ฐํ๋ ์ ์์ต๋๋ค.
ACTIVO๋ ํด๋น ์์ธ๊ฐ ์ ํจํจ์ ๋ํ๋ด๋ ์์์ ๋๋ค.