페루 — 차량 보험

엔드포인트

https://api.verifik.co/v2/pe/vehiculo/soat

본 서비스는 페루 차량의 보험 상태에 대한 정보를 제공합니다. 응답에는 보험사명, 보험 시작·종료일, 차량 번호판, 보험증권 번호, 사용 유형, 차량 등급, 보험 상태 등 상세 정보가 포함됩니다.

헤더(Headers)

이름	값
Content-Type	application/json
Authorization	Bearer <token>

매개변수(Parameters)

이름	형식	필수	설명
plate	string	예	조회할 번호판. 공백이나 점 없이 입력합니다.

요청(Request)

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/pe/vehiculo/soat',
  params: {plate: 'ABC123'},
    headers: {
    Accept: 'application/json',
    Authorization: 'jwt <your_token>'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/pe/vehiculo/soat?plate=", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/pe/vehiculo/soat?plate=")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/pe/vehiculo/soat?plate=');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

응답(Response)

200

{
  "data": {
    "plate": "ABC123",
    "soat": {
      "ConsultarSoatResult": {
        "NombreCompania": "Interseguro",
        "FechaInicio": "27/04/2022",
        "FechaFin": "27/04/2023",
        "Placa": "ABC123",
        "NúmeroPoliza": "000000000000000000001",
        "NombreUsovehiculo": "PARTICULAR",
        "NombreClasevehiculo": "AUTOMOVIL",
        "Estado": "VIGENTE",
        "CodigoUnicoPoliza": "0000000000000000000000008",
        "CodigoSBSAseguradora": "001",
        "FechaControlPolicial": "26/04/2022"
      }
    }
  },
  "signature": {
    "dateTime": "July 19, 2022 3:08 PM",
    "message": "Certified by Verifik.co"
  }
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

409

{
"code": "MissingParameter",
"message": "missing plate\n"
}

활용 사례

• SOAT 검증: 의무 교통 사고 보험의 현재 상태를 검증합니다.
• 보험 서비스: 활성 보험증권과 만료일을 확인합니다.
• 교통 통제: 의무 보험 가입 여부 준수를 검증합니다.
• 운수 기업: 운영 차량 보험을 검증합니다.
• 컴플라이언스 검증: 보험증권 유효성을 확인합니다.

주요 기능

• ✅ 차량 번호판으로 조회
• ✅ 종합 SOAT 보험증권 정보
• ✅ 보험사명
• ✅ 보험 시작·종료일
• ✅ 보험 상태(VIGENTE/INACTIVO)
• ✅ 고유 보험증권 코드
• ✅ SBS 보험사 코드
• ✅ 경찰 통제 일자
• ✅ Verifik.co로 인증된 응답