๐จ๐ฑ ์น ๋ โ ์ฐจ๋ SOAP
์น ๋ ๋ฑ๋ก ์ฐจ๋์ SOAP(Seguro Obligatorio de Accidentes Personales, ์๋ฌด ๊ฐ์ธ์ํด ๋ณดํ) ์กฐํ๋ ์ฐจ๋์ ํ์ ์ธ๋ช ์ฌ๊ณ ๋ณดํ์ ๊ฒ์ฆํฉ๋๋ค. ๋ฒํธํ๊ณผ ๋ณดํ์ฆ๊ถ ๋ฒํธ๋ก AACH ๋ ์ง์คํธ๋ฆฌ์์ ๋ณดํ์ฌ, ์์ ์, ์ ํจ๊ธฐ๊ฐ ๋ฐ ์ฐจ๋ ์์ฑ์ ์กฐํํฉ๋๋ค.
์ฐจ๋ SOAP ์กฐํโ
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/cl/vehicle-soap
๋ฒํธํ(plate)๊ณผ ๋ณดํ์ฆ๊ถ ๋ฒํธ(policyNumber; ์๋น์ค๋ AACH ๋ ์ง์คํธ๋ฆฌ์์ ๋ง์ง๋ง ๋ค ์๋ฆฌ๋ฅผ ์ฌ์ฉ)๋ก ์กฐํํฉ๋๋ค. ์ผ๋ฐ ํ๋: status, insuranceCompany, ownerName, ownerRut, validFrom, validTo, brand, model, manufactureYear, engineNumber, premium โ ๋ณดํ ์ปดํ๋ผ์ด์ธ์ค, ํ๋ฆฟ ์จ๋ณด๋ฉ, ํด๋ ์ ์ํฌํ๋ก์ ์ฌ์ฉํฉ๋๋ค.
ํค๋โ
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์โ
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
plate | string | Yes | ์น ๋ ๋ฒํธํ(Patente), 4โ6์ ์์ซ์. | HTRT86 |
policyNumber | string | Yes | ๋ณดํ์ฆ๊ถ ๋ฒํธ; AACH SOAP ์กฐํ์ ๋ง์ง๋ง ๋ค ์๋ฆฌ ์ฌ์ฉ. | 94596506 |
์์ฒญโ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/cl/vehicle-soap", {
params: { plate: "HTRT86", policyNumber: "94596506" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/cl/vehicle-soap"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"plate": "HTRT86", "policyNumber": "94596506"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
์๋ตโ
- 200
- 404
- 409
{
"data": {
"status": "VIGENTE",
"plate": "HTRT86",
"policyNumber": "94596506",
"vehicleType": "AUTOMOVIL",
"brand": "TOYOTA",
"model": "COROLLA",
"manufactureYear": "2019",
"engineNumber": "ENG123456",
"folioNumber": "FOL789",
"insuranceCompany": "MAPFRE",
"ownerName": "JUAN PEREZ LOPEZ",
"ownerRut": "12.345.678-9",
"validFrom": "01/01/2026",
"validTo": "31/12/2026",
"premium": "$50.000"
},
"signature": {
"dateTime": "June 30, 2026 12:00 PM",
"message": "Certified by Verifik.co"
}
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing plate\n"
}
์ฐธ๊ณ โ
- ์๋๋ฐ์ค ๋ชจ๋:
BBCC12โBBCC21๋ฒํธํ์ ๊ณ ์ SOAP ํ๋กํ ๋ฐํ(BBCC15= VENCIDO);HTRT86+policyNumber=94596506๋ฐ๋ชจ ํ๋กํ;ERR404โ 404; ๋งคํ๋์ง ์์ ๋ฒํธํ์ ์์ 200. - ์๋๋ฐ์ค ์:
BBCC12/94590001(์ธ๋จ, MAPFRE),BBCC18/94590007(ํฝ์ , CHUBB),HTRT86/94596506(TOYOTA COROLLA ๋ฐ๋ชจ). - ์น ๋ ์ผ๋ฐ ์ฐจ๋ ์กฐํ๋ ๐จ๐ฑ ์น ๋ โ ์ฐจ๋ ์ฐธ์กฐ.
- ๋ ์ง์คํธ๋ฆฌ ๊ฐ์ฉ์ฑ์ ํ๊ฒฝ์ ๋ฐ๋ผ ๋ค๋ฅด๋ฉฐ, ์ฅ์ ์ 409 ํ์์์์ด ๋ฐ์ํ ์ ์์ต๋๋ค.