Certificat de la Contraloría

Référence de l'API

Endpoint

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

Ce service permet de vérifier le certificat de bonne conduite délivré par la Contraloría General de Colombia en saisissant le type et le numéro de document, et renvoie la date de consultation ainsi que le certificat au format PDF encodé en base64. Idéal pour confirmer rapidement la régularité d'une entreprise ou d'un particulier en Colombie.

En-têtes (Headers)

Nom	Valeur
Accept	application/json
Authorization	Bearer <token>

Paramètres

info

Pour la liste complète des types de documents pris en charge ainsi que de leurs paramètres obligatoires spécifiques, consultez le guide Types de documents.

Nom	Type	Requis	Description
documentType	string	Oui	Type de document. Valeurs autorisées : CC, CE, PA, PEP.
documentNumber	string	Oui	Numéro de document de la personne à interroger, sans espaces ni points.

Requête (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 <votre_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 <votre_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 <votre_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 <votre_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();
}

Réponse (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 (Paramètres manquants)

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

409 (Type de document invalide)

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