콘트랄로리아 증명서

API 레퍼런스

엔드포인트

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

본 서비스는 문서 종류와 번호를 입력하여 콜롬비아 총감사원(Contraloría General de Colombia)이 발급한 품행 증명서를 검증합니다. 응답에는 조회 일자와 함께 base64로 인코딩된 PDF 형식의 증명서가 포함됩니다. 콜롬비아 기업 또는 개인의 정상 신분 상태를 신속히 확인하는 데 적합한 서비스입니다.

헤더(Headers)

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

매개변수(Parameters)

info

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

이름	형식	필수	설명
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]"
}