🇨🇱 智利 — 驾驶证冻结与暂停记录

通过 RUN 查询智利民事登记与身份服务局（Servicio de Registro Civil e Identificación）的全国驾驶证冻结登记系统。

与仅覆盖单一市镇的市政门户不同，本端点提供智利法院及行政主管机关下达的驾驶证冻结与吊销决定的全国覆盖数据。

端点

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	否	可选布尔值或 1/true，用于绕过服务端缓存直接查询官方数据源。	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 号在智利民事登记处数据库中没有任何驾驶证登记记录。

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."
}

如果输入的校验位未能通过 Modulo 11 算法验证，API 将直接返回不计费的 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 校验保护: 前置校验位识别，杜绝因输入失误而扣减服务额度。