フィンランドの国民ID検証API (JA)
フィンランドの国民IDを、同国の公式政府身元登録機関とリアルタイムで照合し、確定的な結果に対してのみ課金されます。エンドポイント、パラメーター、応答スキーマ、価格設定、および統合について説明します。.

フィンランドのユーザーをオンボーディングする際には、彼らが主張する本人であることを確認する必要があります。フィンランドの国民IDカードの公式発行機関に対して入力データを検証します。書類や入力された情報は、データが存在することを証明するだけであり、それが本物であるか、目の前の人物のものであるかを証明するものではありません。フィンランドの国民ID検証は、国の公式政府身元登録機関に対してデータをチェックすることで、そのギャップを埋めます。このガイドでは、このチェックが何を行うか、正確な技術的詳細、および数分で統合する方法について説明します。
主なポイント:
- チェック内容 — フィンランドの国民ID検証は、同国の公式政府身元登録機関に対して国民IDを検証します。
- 取得できる情報 — 正規化された
match_typeとフィールドレベルの結果。これらは承認/レビュー/却下ロジックに直接組み込むことができます。 - なぜ重要なのか — 書類は偽造できますが、登録記録は偽造できません。信頼できる政府の情報源に対してIDを検証することで、所有者が実在し、正しく識別されていることを確認できます。
- 使用方法 — Diditのデータベース検証エンドポイントへの1回の
POST、またはノーコードワークフローモジュール。1回の確定的なクエリあたり2.10ドルで、数秒で結果が得られます。
フィンランド国民ID検証が検証するもの
フィンランドの国民IDカードの公式発行機関に対して入力データを検証します。Diditはこれを単一のエンドポイントを通じて公開しているため、提出されたデータを国の公式政府身元登録機関に対して検証し、構造化された正規化された結果を受け取ることができます。これは自分で解析する必要がある生の登録ダンプではありません。
確定的な応答は、一致したsource_dataとフィールドごとのvalidationブロックを返し、リスクエンジンが明確で機械が読める判定を得られるようにします。
なぜ重要なのか
書類は偽造できますが、登録記録は偽造できません。信頼できる政府の情報源に対してIDを検証することで、所有者が実在し、正しく識別されていることを確認できます。
フィンランドの規制対象ビジネス(フィンテック、暗号プラットフォーム、貸金業者、マーケットプレイス、ゲーム事業者)にとって、信頼できる情報源に対してチェックを行うことで、IDが情報源で確認されたという弁護可能で監査可能な記録が作成されます。これは、単にフォームや写真からキャプチャされたものではありません。
技術詳細
Diditは、このサービスを統合されたデータベース検証エンドポイントを通じて公開しています。SDKは不要で、単一のPOSTです。
エンドポイント
POST /v3/database-validation/
リクエストパラメーター
| パラメーター | タイプ | 必須 | 説明 |
|---|---|---|---|
issuing_state | string | はい | ISO 3166-1 alpha-3 国コード。FINを使用します。 |
services | string | はい | サービス識別子。fin_national_idを使用します。 |
first_name | string | はい | 名。 |
last_name | string | はい | 姓。 |
date_of_birth | string | はい | 生年月日。 |
national_id | string | はい | 国民ID。 |
address | string | いいえ | 住所(オプションの相互チェック)。 |
リクエスト例
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=FIN" \
-F "services=fin_national_id" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "national_id=1111111"
応答例(確定的な一致)
{
"request_id": "req_01H...",
"status": "Approved",
"issuing_state": "FIN",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "fin_national_id",
"service_name": "Finland National ID",
"source_data": {
"address": "123 Sample Street",
"date_of_birth": "1990-01-01",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe"
},
"validation": {
"date_of_birth": "full_match",
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
パフォーマンスと課金
- レイテンシ:通常数秒。
- 費用:確定的なクエリ1回あたり2.10ドル。確定的な結果に対してのみ課金され、ソースのダウンタイム、フィールドの欠落、ソース前の拒否には課金されません。
- 信頼性:四半期ごとの稼働率目標99.9%のDiditのインフラストラクチャで稼働します。
ユースケース
- フィンテック&ネオバンク — フィンランドでウォレットを開設したり信用を供与したりする前に、実在する検証可能な口座名義人であることを確認します。
- クリプト&Web3 — 信頼できる情報源による本人確認でVASPのオンボーディング要件を満たします。
- 貸付 — ソース検証済みのデータで、合成ID詐欺や第一者詐欺を削減します。
- マーケットプレイス&ギグプラットフォーム — 自己申告フォームだけでなく、信頼できるデータに対してユーザーを検証します。
- iGaming — フィンランドのプレイヤーに対する本人確認と資格確認を、監査可能な記録とともに満たします。
Diditとの統合方法
フィンランドの国民ID検証は、2つの方法で実行できます。
- ノーコードワークフロー。 Diditビジネスコンソールでワークフロービルダーを開き、データベース検証モジュールを追加し、フィンランド → フィンランド国民ID検証を選択してアクティブ化します。一致するユーザーは自動的にルーティングされ、エンジニアリングは不要です。
- 直接API。 上記の
/v3/database-validation/エンドポイントをservices=fin_national_idで呼び出します。match_typeとフィールドごとのvalidationブロックを読み取り、承認/レビュー/却下ロジックを駆動します。
すべてのDiditアカウントには月500回の無料検証が含まれているため、1回のクエリに料金を支払う前に、完全なフローをエンドツーエンドでテストできます。
よくある質問
フィンランド国民ID検証チェックは何を確認しますか?
提出されたデータを国の公式政府身元登録機関に対して検証し、正規化された一致結果を返します。これにより、国民IDが信頼できる情報源に存在するかどうか、およびどのフィールドが一致したかを知ることができます。
ソースが一時的に利用できない場合はどうなりますか?
料金はかかりません。課金は確定的な結果にのみ適用され、ソースのダウンタイム、フィールドの欠落、ソース前の拒否は無料です。
チェックの速度はどれくらいですか?
データベース検証は通常数秒で結果を返すため、リアルタイムのオンボーディングフローに適合します。
SDKは必要ですか?
いいえ。チェックは、単一のエンドポイントへの1回のHTTPS POSTです。ビジネスコンソールでノーコードワークフローに組み込むこともできます。
始めませんか?
本日、最初のフィンランド国民IDを検証してください。
- APIリファレンスを読む: フィンランド国民ID検証
- すべてのデータベース検証を見る: データベース検証の価格とカバレッジ
- 構築を開始する: 無料のDiditアカウントを作成する — 月500回の検証が無料です。