POST公開中idcard-area-query

中国身分証明書発行地検索

中国の身分証明書（IDカード）番号から、省や都市などの発行地情報を検索します。中国本土の身分証明書番号の迅速な検証と照会に対応しています。

導入ドキュメント

機能紹介

本APIは、身分証明書番号の発行地（帰属地）照会サービスを提供します。有効な中国本土の身分証明書番号を入力するだけで、システムがその番号に対応する省および都市情報を返します。このサービスは権威あるデータソースに基づいており、照会結果の正確性とリアルタイム性を確保し、お客様のビジネスに信頼できるデータサポートを提供します。

利用シーン

実名認証：ユーザー登録、取引、またはその他の機密性の高い操作を行う際、ユーザーが提供した身分証明書情報が実際の所在地と一致しているかを検証し、認証の精度を向上させます。
リスクコントロール：金融やECなどの業界では、このAPIを利用してユーザーの地域分布を判断し、他のリスク管理戦略と組み合わせて、潜在的な不正行為を特定できます。
地域データ分析：企業はユーザーの身分証明書発行地データを収集することで、市場分析やペルソナ構築を行い、製品およびマーケティング戦略を最適化できます。
物流・配送の最適化：ECや物流業界において、身分証明書の発行地に基づいて配送先住所の地域を予測し、物流ルートの計画やコスト見積もりをサポートします。
行政サービス：政府機関が業務を行う際、市民の身分情報を照合し、サービスの正確性とコンプライアンスを確保します。

実装サンプルコード

Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。

リクエスト例

{
  "idCardNo": "110105199003078887"
}

レスポンス例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "province": "北京市",
    "city": "北京市",
    "district": "西城区",
    "sex": "男",
    "birthday": "19900307"
  }
}

リクエスト項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
idCardNo	string	110105199003078887

レスポンス項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
code	string	SUCCESS
message	string	success
data	object	{...}
data.province	string	北京市
data.city	string	北京市
data.district	string	西城区
data.sex	string	男
data.birthday

curl --request POST \ --url 'https://openapi.toolkk.com/v1/idcard-area-query' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "idCardNo": "110105199003078887"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/idcard-area-query" payload = { "idCardNo": "110105199003078887" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/idcard-area-query" payload := []byte("{\n \"idCardNo\": \"110105199003078887\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"idCardNo\": \"110105199003078887\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/idcard-area-query")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/idcard-area-query'; $payload = "{\n \"idCardNo\": \"110105199003078887\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

中国身分証明書発行地検索

導入ドキュメント

機能紹介

利用シーン

実装サンプルコード

リクエスト例

レスポンス例

リクエスト項目

レスポンス項目

Shell 例

Python 例

Go 例

Java 例

PHP 例

オンライン試用