콜롬비아 경찰 범죄 경력 조회

API 레퍼런스

Endpoint

https://api.verifik.co/v2/co/policia/consultar

콜롬비아 경찰 범죄 경력 조회는 헌법 제248조에 따라 사법 당국과 미결 사항이 있는지를 확인합니다. documentType 과 documentNumber 를 GET(쿼리) 또는 POST(JSON 본문)으로 보냅니다. 성공 시 data에는 documentType, documentNumber, firstName, lastName, fullName, arrayName, details가 포함됩니다. 채용, 온보딩, 실사 배경 조회에 사용합니다.

헤더(Headers)

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

매개변수(Parameters)

info

지원되는 문서 종류의 전체 목록과 각 종류별 필수 매개변수는 Document Types 가이드를 참고해 주세요.

이름	형식	필수	설명
documentType	string	예	문서 종류. 허용 값: CC, CE, PPT, PA, DP. DP는 Documento Diplomático(외교 문서)입니다. PPT는 허용되며, 경찰 포털에서 여권처럼 매핑됩니다.
documentNumber	string	예	조회 대상자의 문서 번호. 공백이나 점 없이 입력합니다.

이 엔드포인트는 date 매개변수를 받지 않습니다(RNMC와 다름).

요청(Request)

JavaScript

import axios from "axios";

const options = {
  method: "GET",
  url: "https://api.verifik.co/v2/co/policia/consultar",
  params: { documentType: "CC", documentNumber: "1032386359" },
  headers: {
    Accept: "application/json",
    Authorization: "Bearer <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/co/policia/consultar?documentType=CC&documentNumber=1032386359", 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/co/policia/consultar?documentType=CC&documentNumber=1032386359")!,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/co/policia/consultar?documentType=CC&documentNumber=1032386359');
$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": {
    "documentType": "CC",
    "documentNumber": "1032386359",
    "firstName": "LILIA MANUELA",
    "lastName": "LESPORT FERNANDEZ",
    "fullName": "LILIA MANUELA LESPORT FERNANDEZ",
    "arrayName": ["LILIA", "MANUELA", "LESPORT", "FERNANDEZ"],
    "details": "NO TIENE ASUNTOS PENDIENTES CON LAS AUTORIDADES JUDICIALES de conformidad con lo establecido en el artículo 248 de la Constitución Política de Colombia."
  },
  "signature": {
    "dateTime": "March 13, 2024 10:48 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "7QS69"
}

404

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

409 (누락된 매개변수)

{
  "code": "MissingParameter",
  "message": "missing documentType\n. missing documentNumber\n"
}

409 (잘못된 문서 종류)

{
  "code": "MissingParameter",
  "message": "documentType must be one of: [CC,CE,PPT,PA,DP]"
}

409 (업스트림 불가)

{
  "code": "Endpoint_out_of_service",
  "message": "Endpoint_out_of_service"
}

참고 (Notes)

• GET과 POST를 모두 지원합니다. POST는 동일한 필드를 JSON 본문으로 보냅니다.
• 경찰 포털은 성(apellidos) 다음 이름(nombres) 순으로 표시합니다. Verifik는 이름을 먼저 반환합니다: firstName LILIA MANUELA, lastName LESPORT FERNANDEZ, fullName LILIA MANUELA LESPORT FERNANDEZ, arrayName은 이름 다음 성입니다.
• 프로덕션 data.details는 NO TIENE / REGISTRA ASUNTOS 문장만 포함합니다. 헌법 설명 문구는 제거됩니다.
• 샌드박스는 legend를 포함할 수 있습니다. legend를 프로덕션 보장 필드로 취급하지 마세요.
• 허용 documentType은 CC, CE, PPT, PA, DP(Documento Diplomático)입니다. PPT는 허용되며 포털에서 여권처럼 매핑됩니다.
• 이 경로는 발급 date가 필요 없습니다(RNMC는 필요).
• 일시적인 업스트림 또는 captcha 실패는 409와 Endpoint_out_of_service 또는 captcha_failed를 반환합니다.
• 미이행 시정 조치는 콜롬비아 — RNMC 시정 조치 (GET /v2/co/policia/rnmc)를 사용하세요.