🇵🇪 秘鲁 — 外国人身份证（CE）

秘鲁身份核验服务允许通过外国人身份证号核验在秘鲁的个人身份。该服务返回个人姓名全称及其他相关信息，包括移民身份、国籍、居留到期、外国人身份证详情等，并附带签名以证明响应的真实性。

该服务非常适合用于核验在秘鲁的外国居民，并获取其移民身份与证件有效性。

Endpoint

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

请求头（Headers）

名称	取值
Content-Type	application/json
Authorization	Bearer <token>

参数（Parameters）

名称	类型	必填	描述	示例
documentNumber	string	是	待查询人员的证件号码。	005015372
dateOfBirth	string	是	证件持有人的出生日期。	16/08/1993

请求（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()

响应（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

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

409 - dateOfBirth 格式无效

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

功能特性

• 外国人身份证核验：在秘鲁核验外国人身份证件。
• 移民身份查询：获取当前移民身份（例如 HUMANITARIA）。
• 国籍信息：获取外国居民的国籍信息。
• 证件有效性：查询外国人身份证的到期与上次签发日期。
• 居留状态：核验居留到期日期。
• 个人信息：获取姓名全称、名、姓与出生日期。
• 证件号校验：核验外国人证件号码。
• 日期格式校验：确保出生日期格式为 DD/MM/YYYY。
• 多语言支持：兼容 JavaScript、Python、PHP 与 Swift。
• 实时数据：获取最新的外国人信息。
• 完善错误处理：针对多种场景返回详细错误响应。
• 秘鲁移民数据接入：直接对接秘鲁官方移民数据库。
• 外国人证件管理：覆盖外国人身份证的完整生命周期。
• 居留合规：监控居留状态与到期日期。