🇵🇪 ペルー — 外国人 ID

ペルーの本人確認サービスでは、外国人 ID 番号を指定して、ペルーにおける個人の本人確認を行えます。本サービスは、対象者の氏名やその他の関連情報（在留資格、国籍、在留期限、外国人 ID の詳細）を返し、レスポンスの真正性を保証する署名も含まれます。

ペルーの外国人居住者を検証し、その在留資格や文書の有効性を取得する用途に有効です。

エンドポイント

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

ヘッダー

名前	値
Content-Type	application/json
Authorization	Bearer <token>

パラメーター

名前	型	必須	説明	例
documentNumber	string	はい	照会対象者の文書番号。	005015372
dateOfBirth	string	はい	文書所有者の生年月日。	16/08/1993

リクエスト

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()

レスポンス

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"
}

機能

• 外国人 ID 検証: ペルーにおける外国人の身分証明書を検証します。
• 在留資格の確認: 現在の在留資格（例: HUMANITARIA）を取得します。
• 国籍情報: 外国人居住者の国籍情報を取得します。
• 文書の有効性: 外国人 ID の有効期限および直近の発行日を確認します。
• 在留状況: 在留期限を検証します。
• 個人情報: 氏名、名、姓、生年月日にアクセスできます。
• 文書番号の検証: 外国人文書番号を検証します。
• 日付フォーマット検証: 生年月日が正しいフォーマット（DD/MM/YYYY）であることを保証します。
• 複数のプログラミング言語に対応: JavaScript、Python、PHP、Swift をサポートします。
• リアルタイムデータ: 最新の外国人情報にアクセスできます。
• 包括的なエラーハンドリング: 各種シナリオに対応した詳細なエラーレスポンスを提供します。
• ペルー入国管理との連携: ペルーの公式入国管理データベースに直接アクセスできます。
• 外国人文書管理: 外国人 ID のライフサイクル全体を追跡します。
• 在留コンプライアンス: 在留状況や有効期限を監視します。