🇵🇪 Pérou — CE (résident étranger)

Le service de vérification d'identité péruvienne pour étrangers vous permet de vérifier l'identité d'une personne au Pérou à partir de son numéro de pièce d'étranger (CE). Le service retourne le nom complet et d'autres informations associées : statut migratoire, nationalité, date d'expiration de la résidence et détails de la pièce d'étranger, accompagnés d'une signature certifiant l'authenticité de la réponse.

Ce service est utile pour vérifier les résidents étrangers au Pérou et accéder à leur statut migratoire ainsi qu'à la validité de leur document.

Endpoint

GET https://api.verifik.co/v2/pe/foreigner-id/ce

En-têtes (Headers)

Nom	Valeur
Content-Type	application/json
Authorization	Bearer <token>

Paramètres

Nom	Type	Requis	Description	Exemple
documentNumber	string	Oui	Numéro de document de la personne à interroger.	005015372
dateOfBirth	string	Oui	Date de naissance du titulaire du document.	16/08/1993

Requête (Request)

JavaScript

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api.verifik.co/v2/pe/foreigner-id/ce',
  params: {
    documentNumber: '005015372',
    dateOfBirth: '16/08/1993'
  },
  headers: { 
    'Authorization': 'Bearer <token>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/pe/foreigner-id/ce?documentNumber=005015372&dateOfBirth=16/08/1993", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/pe/foreigner-id/ce?documentNumber=005015372&dateOfBirth=16/08/1993');
$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();
}
?>

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/pe/foreigner-id/ce?documentNumber=005015372&dateOfBirth=16/08/1993")!,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()

Réponse (Response)

200

{
  "data": {
    "arrayName": [
      "CORDERO",
      "SANCHEZ",
      "ANA",
      "RENE"
    ],
    "dateOfBirth": "16/08/1993",
    "documentNumber": "005015372",
    "firstName": "ANA RENE",
    "foreignerIdExpiration": "12/08/2025",
    "foreignerIdLastIssuance": "12/08/2021",
    "fullName": "ANA RENE CORDERO SANCHEZ",
    "immigrationStatus": "HUMANITARIA",
    "lastName": "CORDERO CAMPERO",
    "nationality": "VENEZOLANA",
    "residenceExpiration": "26/02/2025"
  },
  "signature": {
    "dateTime": "November 6, 2024 3:22 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "K0MMA"
}

404

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

409 - documentNumber manquant

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

409 - Format dateOfBirth invalide

{
  "code": "MissingParameter",
  "message": "dateOfBirth format required: DD/MM/YYYY\n"
}

Fonctionnalités

• Vérification de la pièce d'étranger : confirmez l'authenticité des documents d'étrangers au Pérou.
• Statut migratoire : accédez au statut migratoire courant (par ex. HUMANITARIA).
• Nationalité : obtenez la nationalité du résident étranger.
• Validité du document : vérifiez la date d'expiration et la dernière date de délivrance de la pièce d'étranger.
• Statut de résidence : vérifiez la date d'expiration de la résidence.
• Informations personnelles : nom complet, prénom, nom de famille et date de naissance.
• Validation du numéro de document : confirmez le numéro de document d'étranger.
• Validation du format de date : assurez le bon format de date de naissance (JJ/MM/AAAA).
• Plusieurs langages de programmation : exemples en JavaScript, Python, PHP et Swift.
• Données en temps réel : informations à jour sur les étrangers résidents.
• Gestion d'erreurs complète : réponses détaillées pour chaque scénario.
• Intégration migration péruvienne : accès direct à la base officielle de l'immigration au Pérou.
• Suivi du cycle de vie de la pièce d'étranger : gestion complète des documents.
• Conformité résidentielle : surveillez le statut et les dates d'expiration de la résidence.