POST公開中personal-limit-high-consumption

消費制限対象者照会

氏名、ID番号、携帯電話番号に基づいて、個人が制限された高額支出リストに含まれているかどうかを確認し、リスク管理レビューや身元調査に適した確認結果と関連記録リストを返します。

利用料金

20 コイン/回

オンライン試用

コード不要、ブラウザから本物のリクエストを送信

導入ドキュメント

インターフェース機能

消費制限対象者照会APIは、企業が個人の氏名、ID番号、携帯電話番号を入力することで、高額消費制限対象者（以下「上限」といいます。）に該当するかどうかを照会することができます。このインターフェイスは、明確な検証結果 (リストに含まれているかどうかなど)、関連するレコードの総数および詳細のリストを返します。このインターフェイスは、企業の信用評価、リスク管理、身元調査のための補助情報を提供できます。

リクエストと返却

リクエストパラメータ: 照会される人の name (名前)、idcard_number (ID カード番号)、および mobile_number (携帯電話番号) を同時に提供する必要があります。入力した情報が真実で、有効で、一致していることを確認してください。
結果を返す: 返された data オブジェクトの result フィールドは現在のステータス (「消費制限リストに含まれていない」など) を示し、total は関連レコードの数を表し、list 配列には特定の高さ制限レコードの詳細 (存在する場合) が含まれます。
失敗のトラブルシューティング: クエリが失敗するか、エラーが報告される場合は、ID 番号の形式が正しいかどうか、および携帯電話番号が標準の 11 桁の番号であるかどうかを確認してください。

使用シナリオ

金融信用リスク管理: 融資やクレジットカードの承認などの業務を行う前に、信用リスクを防ぐために、申請者が与信限度額の記録を持っているかどうかを確認します。
企業の入社経歴調査: 候補者に重大な信頼違反がないことを確認するために、上級幹部または中核的な財務職の入社前の経歴調査を実施します。
業務協力評価: 重要な契約を締結する前に、パートナーの法定代理人または実際の管理者の信用調査を実施します。

指示と制限事項

プライバシー保護: このインターフェイスには機密の個人情報が含まれます。電話をかける際は、関連する法律や規制を必ず遵守し、問い合わせを受ける相手から明示的な許可を得ていることを確認し、データの収集と送信を最小限に抑える原則を実行し、関連データを適切に保管してください。
インターフェイスによって返される結果は、リスクの判断を支援することのみを目的としており、法的な結論や司法的評価の根拠を構成するものではありません。

・データ更新に遅れが生じる場合がございます。最新の状況については、公式公開情報をご確認ください。

実装サンプルコード

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

リクエスト例

{
  "name": "张三",
  "idcard_number": "110105199003078887",
  "mobile_number": "13800138000"
}

レスポンス例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "result": "未列入限制消费名单",
    "total": 0,
    "list": []
  }
}

リクエスト項目

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

パス	型	サンプル値
name	string	张三
idcard_number	string	110105199003078887
mobile_number	string	13800138000

レスポンス項目

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

パス	型	サンプル値
code	string	SUCCESS
message	string	success
data	object	{...}
data.result	string	未列入限制消费名单
data.total	number	0
data.list	array	[]

curl --request POST \ --url 'https://openapi.toolkk.com/v1/personal-limit-high-consumption' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "name": "张三",\n "idcard_number": "110105199003078887",\n "mobile_number": "13800138000"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/personal-limit-high-consumption" payload = { "name": "张三", "idcard_number": "110105199003078887", "mobile_number": "13800138000" } 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/personal-limit-high-consumption" payload := []byte("{\n \"name\": \"张三\",\n \"idcard_number\": \"110105199003078887\",\n \"mobile_number\": \"13800138000\"\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 \"name\": \"张三\",\n \"idcard_number\": \"110105199003078887\",\n \"mobile_number\": \"13800138000\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/personal-limit-high-consumption")) .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/personal-limit-high-consumption'; $payload = "{\n \"name\": \"张三\",\n \"idcard_number\": \"110105199003078887\",\n \"mobile_number\": \"13800138000\"\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;