Validation biométrique

POST/veriface/validateclé privéeprk_

Service permettant d'obtenir la similarité entre une pièce d'identité et la photographie d'une personne à l'aide d'algorithmes d'IA, en validant l'authenticité des photos.

Authentification

Incluez votre clé privée dans l'en-tête Authorization.

Authorization: prk_xxx...

Paramètres de la requête

Nom	Description
country String	Obligatoire. Pays de la personne à valider. Consultez la liste des documents et des pays
type String	Obligatoire. Type de document de la personne à valider. Consultez la liste des documents et des pays
identification String	Obligatoire. Numéro d'identification de la personne à consulter.
documentImage String	Obligatoire. Image du document en base64 ou URL publique pour accéder à l'image. L'image doit être au format JPEG ou PNG.
photo String	Obligatoire. Image du visage de la personne en base64 ou URL publique pour accéder à l'image. L'image doit être au format JPEG ou PNG.

🧪 Exemples d'utilisation

Curl

curl -X POST '{{api_auco}}/veriface/validate' \
  -H 'Authorization: {{private_key}}' \
  -d '{
    "country": "CO",
    "type": "CC",
    "identification": "1001001010",
    "photo": "https://url.com/photo.jpg",
    "documentImage": "https://url.com/document.jpg"
  }'

Python

import requests

response = requests.post(
  '{{api_auco}}/veriface/validate',
  headers={'Authorization': '{{private_key}}'},
  json={
    "country": "CO",
    "type": "CC",
    "identification": "1001001010",
    "photo": "https://url.com/photo.jpg",
    "documentImage": "https://url.com/document.jpg"
  }
)
print(response.json())

Node.js

const axios = require('axios');

axios.post('{{api_auco}}/veriface/validate', {
  country: "CO",
  type: "CC",
  identification: "1001001010",
  photo: 'https://url.com/photo.jpg',
  documentImage: 'https://url.com/document.jpg'
}, {
  headers: { Authorization: '{{private_key}}' }
})
.then((response) => console.log(response.data));

📥 Exemples de réponses

Validation réussie.

{
  "error": false,
  "similarity": 89.46871185302734,
  "code": "JPJD42IDWP3Z6RXA",
  "identificationCard": {
    "error": false,
    "isFront": true,
    "data": {
      "bloodGroup": "O+",
      "dateOfBirth": "1990-01-01",
      "dateOfExpiry": "2030-01-01",
      "firstIssueDate": "01 SEPT 2000 BOGOTÁ D.C. ",
      "fullName": "PEREZ PEREZ JUAN ALBERTO",
      "givenNames": "JUAN ALBERTO",
      "height": "170 cm",
      "issuingStateName": "Colombia",
      "nationality": "Colombia",
      "nationalityCode": "COL",
      "personalNumber": "1001001010",
      "placeOfBirth": "BOGOTÁ D.C. (CUNDINAMARCA)",
      "sex": "M",
      "surname": "PEREZ PEREZ",
      "documentType": "Id Card",
      "name": "JUAN ALBERTO PEREZ PEREZ"
    }
  }
}

Validation échouée.

{
  "error": true,
  "similarity": 49.4231344,
  "code": "JPJD42IDWP3Z6RXA",
  "identificationCard": {
    "error": true,
    "message": "DOCUMENT_FAKE",
    "isFront": false,
    "data": { }
  }
}

⚠️ Réponses d'erreur

Code	Description
400	Paramètres manquants tels que photo ou documentImage. Format d'image incorrect.
401	Authentification invalide ou manquante.