审计长（Contraloría）证明

API 参考

Endpoint

https://api.verifik.co/v2/co/contraloria/certificado

通过提交证件类型与号码，本服务可核验哥伦比亚总审计长（Contraloría General de Colombia）签发的良好行为证明，并返回查询日期及以 base64 编码的 PDF 证明文件。该服务非常适合用于快速确认某哥伦比亚企业或个人的合规状态。

请求头（Headers）

名称	取值
Accept	application/json
Authorization	Bearer <token>

参数（Parameters）

info

有关支持的证件类型及其专属必填参数的完整清单，请参阅 证件类型 指南。

名称	类型	必填	描述
documentType	string	是	证件类型。允许取值：CC、CE、PA、PEP。
documentNumber	string	是	待查询人员的证件号码，不含空格或圆点。

请求（Request）

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/contraloria/certificado',
  params: {documentType: 'CC', documentNumber: '123456789'},
  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 = {
    'Accept': 'application/json',
    'Authorization': 'Bearer <your_token>'
}
conn.request("GET", "/v2/co/contraloria/certificado?documentType=CC&documentNumber=123456789", 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/contraloria/certificado?documentType=CC&documentNumber=123456789")!,
                         timeoutInterval: Double.infinity)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("Bearer <your_token>", forHTTPHeaderField: "Authorization")

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/contraloria/certificado?documentType=CC&documentNumber=123456789');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setHeader('Accept', 'application/json');
$request->setHeader('Authorization', 'Bearer <your_token>');
$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": "1020729123",
    "searchDate": "2022-03-22T15:37:23.487Z",
    "pdfBase64": "data:application/pdf;base64,STRING_BASE_64"
  },
  "signature": {
    "dateTime": "March 22, 2022 4:37 AM",
    "message": "Certified by Verifik.co"
  }
}

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, PA, PEP]"
}