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