🇨🇱 칠레 — 운전면허 정지 및 차단 등록부

Servicio de Registro Civil e Identificación의 전국 운전면허 차단 등록부를 RUN 번호로 조회합니다.

단일 코뮌만 지원하는 지자체 포털과 달리, 본 엔드포인트는 칠레 전역의 법원 및 행정 기관에서 명령한 운전면허 정지 및 차단에 대한 전국 단위 커버리지를 제공합니다.

엔드포인트

GET https://api.verifik.co/v2/cl/driver-license/block

헤더(Headers)

이름	값
Accept	application/json
Authorization	Bearer <token>

매개변수(Parameters)

이름	형식	필수	설명	예시
documentNumber	string	예	검증 번호(DV)가 포함된 칠레 RUN 번호. 마침표 및 하이픈은 선택 사항입니다(18.347.440-5 또는 18347440-5). 검증 번호는 올바른 Modulo 11 계산값이어야 합니다.	18347440-5
force	boolean	아니요	서버 캐시를 우회하고 출처 기관에 직접 조회할지 여부.	false

요청(Request)

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/cl/driver-license/block',
  params: {
    documentNumber: '18347440-5'
  },
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer <token>'
  }
};

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

Python

import requests

url = "https://api.verifik.co/v2/cl/driver-license/block"
params = {"documentNumber": "18347440-5"}
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, params=params, headers=headers)
print(response.json())

cURL

curl -X GET "https://api.verifik.co/v2/cl/driver-license/block?documentNumber=18347440-5" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <token>"

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.verifik.co/v2/cl/driver-license/block?documentNumber=18347440-5",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => array(
    "Accept: application/json",
    "Authorization: Bearer <token>"
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/cl/driver-license/block?documentNumber=18347440-5")!)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")

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

응답(Response)

200 (차단 없음)

{
  "data": {
    "documentNumber": "18347440-5",
    "fullName": "MACÍAS IBARRA LEONARDO ANTONIO",
    "hasBlock": false,
    "blockStatusText": "NO SE REGISTRA BLOQUEO para los datos ingresados"
  },
  "signature": {
    "dateTime": "October 27, 2026 10:07 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "B752U"
}

200 (차단 기록 있음)

{
  "data": {
    "documentNumber": "10000001-6",
    "fullName": "GONZÁLEZ PÉREZ JUAN CARLOS",
    "licenseNumber": "10000001",
    "hasBlock": true,
    "blockStatusText": "REGISTRA BLOQUEO",
    "block": {
      "date": "15/03/2024",
      "type": "JUDICIAL",
      "reason": "ORDEN JUDICIAL JUZGADO POLICIA LOCAL",
      "status": "REGISTRA BLOQUEO",
      "code": "1"
    }
  },
  "signature": {
    "dateTime": "October 27, 2026 10:07 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "A1B2C"
}

404 (기록 없음)

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

404 응답은 조회된 RUN 번호에 대해 Registro Civil 데이터베이스에 운전면허 발급 이력이 없음을 의미합니다.

409 (검증 번호 불일치)

{
  "code": "invalid_check_digit",
  "message": "documentNumber has a check digit (DV) that does not match the RUN/RUT. Send the number with the correct check digit, or without it."
}

입력된 검증 번호(DV)가 Modulo 11 검증을 통과하지 못하면 크레딧 차감 없이 즉시 409 상태 코드를 반환합니다.

409 (검증 번호 누락)

{
  "code": "MissingParameter",
  "message": "documentNumber must be a Chilean RUN with a valid check digit, e.g. 12345678-5"
}

주요 기능

• 전국 등록부 조회: 칠레 Servicio de Registro Civil e Identificación 공식 데이터.
• 면허 정지 및 차단 여부 즉시 확인: hasBlock: true/false로 신속 판별.
• 명의자 성명 검증: 운전면허 자격에 등록된 공식 법적 성명 반환.
• 차단 메타데이터: 법원 명령 일자, 정지 유형 및 사유 상세 제공.
• Modulo 11 검증 보호: 오타 입력 시 사전 감지하여 불필요한 크레딧 차감 방지.