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

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