接入文档
数据智能产品体系
FinStackStd-PHL
FinStackStd-PHL

# 一、接口描述

通过三要素入参，返回多头基础特征、时间分布特征、多头升温等

# 二、接口地址

https://api-idn.yljz.com/finauth/v3/riskinfo/mhphlstd

# 三、调用方法

POST（需使用form-data格式请求）

# 四、请求参数

可选/必选 参数英文名 类型 参数说明
必选 sign String 签名生成规则参考鉴权说明
必选 sign_version String 签名算法版本号，目前仅支持:"hmac_sha1"
必选 id_number
 String
 身份证号（md5/sha256/sm3）
【注意：如有字母需大写】
必选 id_type
 String
 证件号类型,传入对应的数字即可，如“1”
1：National ID / PhilID
2：CRN / UMID
3：SSS Number
4：GSIS Number
5：PHIC / PhilHealth Number
6：Pag-IBIG MID Number
7：TIN
8：Philippine Passport Number
9：LTO Driver’s License No.
10：Voter’s ID Number
11：PRC ID Number
12：Postal ID Number
必选 phone
 String 手机号（md5/sha256/sm3）
【注意：不需要加国家码】
必选（二选一）
 face_image_file File 人脸图片（不能超过2M）
face_image_base64 String 人脸图片Base64
可选
 hash_type
 String 身份证及手机号的哈希方式：
md5(默认)
sha256
sm3

# 五、产品出参

序号 参数英文名 参数中文名 类型 参数说明
1 org_cnt_1d 近1天查询机构数 int 0+
2 org_cnt_3d 近3天查询机构数 int 0+
3 org_cnt_7d 近7天查询机构数 int 0+
4 org_cnt_14d 近14天查询机构数 int 0+
5 org_cnt_21d 近21天查询机构数 int 0+
6 org_cnt_30d 近30天查询机构数 int 0+
7 org_cnt_90d 近90天查询机构数 int 0+
8 query_cnt_1d 近1天查询次数 int 0+
9 query_cnt_3d 近3天查询次数 int 0+
10 query_cnt_7d 近7天查询次数 int 0+
11 query_cnt_14d 近14天查询次数 int 0+
12 query_cnt_21d 近21天查询次数 int 0+
13 query_cnt_30d 近30天查询次数 int 0+
14 query_cnt_90d 近90天查询次数 int 0+
15 last_query_days 最近一次查询距今天数 int [1,90]
16 first_query_days 首次查询距今天数 int [1,90]
17 active_days_7d 近7天有查询行为天数 int 0‑7
18 active_days_30d 近30天有查询行为天数 int 0‑30
19 max_daily_query_cnt_7d 近7天单日最高查询次数 int 0+
20 max_daily_query_cnt_30d 近30天单日最高查询次数 int 0+
21 night_query_ratio_7d 近7天夜间查询占比 decimal 0‑1 / null
22 night_query_ratio_30d 近30天夜间查询占比 decimal 0‑1 / null
23 avg_query_interval_7d 近7天平均查询间隔 decimal 0+ / null
24 avg_query_interval_30d 近30天平均查询间隔 decimal 0+ / null
25 query_time_variance_7d 近7天查询时间方差 decimal 0+ / null
26 query_time_variance_30d 近30天查询时间方差 decimal 0+ / null
27 top1_org_query_ratio_7d 近7天查询最多机构次数占比 decimal 0‑1 / null
28 top1_org_query_ratio_30d 近30天查询最多机构次数占比 decimal 0‑1 / null
29 new_org_cnt_7d 近7天新增查询机构数 int 0+
30 new_org_cnt_30d 近30天新增查询机构数 int 0+
31 same_org_repeat_cnt_7d 近7天同机构重复查询次数 int 0+
32 same_org_repeat_cnt_30d 近30天同机构重复查询次数 int 0+
33 continuous_2d_query_cnt_7d 近7天连续2日查询次数 int 0+
34 continuous_2d_query_cnt_30d 近30天连续2日查询次数 int 0+
35 continuous_3d_query_cnt_7d 近7天连续3日查询次数 int 0+
36 continuous_3d_query_cnt_30d 近30天连续3日查询次数 int 0+
37 continuous_2d_multi_org_cnt_7d 近7天连续2日及以上多机构查询次数 int 0+
38 continuous_2d_multi_org_cnt_30d 近30天连续2日及以上多机构查询次数 int 0+
39 continuous_3d_multi_org_cnt_7d 近7天连续3日及以上多机构查询次数 int 0+
40 continuous_3d_multi_org_cnt_30d 近30天连续3日及以上多机构查询次数 int 0+
41 query_cnt_ratio_1d_3d 近1天/近3天查询次数比例 decimal 0+ / null
42 query_cnt_ratio_3d_7d 近3天/近7天查询次数比例 decimal 0+ / null
43 query_cnt_ratio_7d_14d 近7天/近14天查询次数比例 decimal 0+ / null
44 query_cnt_ratio_3d_14d 近3天/近14天查询次数比例 decimal 0+ / null
45 query_cnt_ratio_7d_30d 近7天/近30天查询次数比例 decimal 0+ / null
46 query_avg_ratio_1d_3d 近1天日均/近3天日均查询次数比例 decimal 0+ / null
47 query_avg_ratio_3d_7d 近3天日均/近7天日均查询次数比例 decimal 0+ / null
48 query_avg_ratio_7d_14d 近7天日均/近14天日均查询次数比例 decimal 0+ / null
49 query_avg_ratio_3d_14d 近3天日均/近14天日均查询次数比例 decimal 0+ / null
50 query_avg_ratio_7d_30d 近7天日均/近30天日均查询次数比例 decimal 0+ / null
51 org_cnt_ratio_1d_3d 近1天/近3天查询机构数比例 decimal 0+ / null
52 org_cnt_ratio_3d_7d 近3天/近7天查询机构数比例 decimal 0+ / null
53 org_cnt_ratio_7d_14d 近7天/近14天查询机构数比例 decimal 0+ / null
54 org_cnt_ratio_3d_14d 近3天/近14天查询机构数比例 decimal 0+ / null
55 org_cnt_ratio_7d_30d 近7天/近30天查询机构数比例 decimal 0+ / null
56 org_avg_ratio_1d_3d 近1天日均/近3天日均查询机构数比例 decimal 0+ / null
57 org_avg_ratio_3d_7d 近3天日均/近7天日均查询机构数比例 decimal 0+ / null
58 org_avg_ratio_7d_14d 近7天日均/近14天日均查询机构数比例 decimal 0+ / null
59 org_avg_ratio_3d_14d 近3天日均/近14天日均查询机构数比例 decimal 0+ / null
60 org_avg_ratio_7d_30d 近7天日均/近30天日均查询机构数比例 decimal 0+ / null
61 usb_face_verify_cnt_30d 近30天USB直连设备人脸验证次数 int 0+ / null
62 usb_face_verify_cnt_60d 近60天USB直连设备人脸验证次数 int 0+ / null
63 usb_face_verify_cnt_90d 近90天USB直连设备人脸验证次数
 int 0+ / null
64 charging_face_verify_cnt_30d 近30天充电状态设备人脸验证次数
 int 0+ / null
65 charging_face_verify_cnt_60d 近60天充电状态设备人脸验证次数 int 0+ / null
66 charging_face_verify_cnt_90d 近90天充电状态设备人脸验证次数 int 0+ / null
67 root_face_verify_cnt_30d 近30天Root设备人脸验证次数 int 0+ / null
68 root_face_verify_cnt_60d 近60天Root设备人脸验证次数 int 0+ / null
69 root_face_verify_cnt_90d 近90天Root设备人脸验证次数 int 0+ / null
70 injection_face_verify_cnt_30d 近30天注入设备人脸验证次数 int 0+ / null
71 injection_face_verify_cnt_60d 近60天注入设备人脸验证次数 int 0+ / null
72 injection_face_verify_cnt_90d 近90天注入设备人脸验证次数 int 0+ / null
73 hook_face_verify_cnt_30d 近30天Hook设备人脸验证次数 int 0+ / null
74 hook_face_verify_cnt_60d 近60天Hook设备人脸验证次数 int 0+ / null
75 hook_face_verify_cnt_90d 近90天Hook设备人脸验证次数 int 0+ / null
76 virtual_env_face_verify_cnt_30d 近30天虚拟环境设备人脸验证次数 int 0+ / null
77 virtual_env_face_verify_cnt_60d 近60天虚拟环境设备人脸验证次数 int 0+ / null
78 virtual_env_face_verify_cnt_90d
 近90天虚拟环境设备人脸验证次数 int 0+ / null
79 all_org_cnt_1d 全量口径‑近1天查询机构数 int 0+
80 all_org_cnt_3d 全量口径‑近3天查询机构数 int 0+
81 all_org_cnt_7d 全量口径‑近7天查询机构数 int 0+
82 all_org_cnt_14d 全量口径‑近14天查询机构数 int 0+
83 all_org_cnt_21d 全量口径‑近21天查询机构数 int 0+
84 all_org_cnt_30d 全量口径‑近30天查询机构数 int 0+
85 all_org_cnt_90d 全量口径‑近90天查询机构数 int 0+
86 all_query_cnt_1d 全量口径‑近1天查询次数 int 0+
87 all_query_cnt_3d 全量口径‑近3天查询次数 int 0+
88 all_query_cnt_7d 全量口径‑近7天查询次数 int 0+
89 all_query_cnt_14d 全量口径‑近14天查询次数 int 0+
90 all_query_cnt_21d 全量口径‑近21天查询次数 int 0+
91 all_query_cnt_30d 全量口径‑近30天查询次数 int 0+
92 all_query_cnt_90d 全量口径‑近90天查询次数 int 0+
93 all_last_query_days 全量口径‑最近一次查询距今天数 int [1,90]
94 all_first_query_days 全量口径‑首次查询距今天数 int [1,90]
95 all_active_days_7d 全量口径‑近7天有查询行为天数 int 0‑7
96 all_active_days_30d 全量口径‑近30天有查询行为天数 int 0‑30
97 all_max_daily_query_cnt_7d 全量口径‑近7天单日最高查询次数 int 0+
98 all_max_daily_query_cnt_30d 全量口径‑近30天单日最高查询次数 int 0+
99 all_night_query_ratio_7d 全量口径‑近7天夜间查询占比 decimal 0‑1 / null
100 all_night_query_ratio_30d 全量口径‑近30天夜间查询占比 decimal 0‑1 / null
101 all_avg_query_interval_7d 全量口径‑近7天平均查询间隔 decimal 0+ / null
102 all_avg_query_interval_30d 全量口径‑近30天平均查询间隔 decimal 0+ / null
103 all_query_time_variance_7d 全量口径‑近7天查询时间方差 decimal 0+ / null
104 all_query_time_variance_30d 全量口径‑近30天查询时间方差 decimal 0+ / null
105 all_top1_org_query_ratio_7d 全量口径‑近7天查询最多机构次数占比 decimal 0‑1 / null
106 all_top1_org_query_ratio_30d 全量口径‑近30天查询最多机构次数占比 decimal 0‑1 / null
107 all_new_org_cnt_7d 全量口径‑近7天新增查询机构数 int 0+
108 all_new_org_cnt_30d 全量口径‑近30天新增查询机构数 int 0+
109 all_same_org_repeat_cnt_7d 全量口径‑近7天同机构重复查询次数 int 0+
110 all_same_org_repeat_cnt_30d 全量口径‑近30天同机构重复查询次数 int 0+
111 all_continuous_2d_query_cnt_7d 全量口径‑近7天连续2日查询次数 int 0+
112 all_continuous_2d_query_cnt_30d 全量口径‑近30天连续2日查询次数 int 0+
113 all_continuous_3d_query_cnt_7d 全量口径‑近7天连续3日查询次数 int 0+
114 all_continuous_3d_query_cnt_30d 全量口径‑近30天连续3日查询次数 int 0+
115 all_continuous_2d_multi_org_cnt_7d 全量口径‑近7天连续2日及以上多机构查询次数 int 0+
116 all_continuous_2d_multi_org_cnt_30d 全量口径‑近30天连续2日及以上多机构查询次数 int 0+
117 all_continuous_3d_multi_org_cnt_7d 全量口径‑近7天连续3日及以上多机构查询次数 int 0+
118 all_continuous_3d_multi_org_cnt_30d 全量口径‑近30天连续3日及以上多机构查询次数 int 0+
119 all_query_cnt_ratio_1d_3d 全量口径‑近1天/近3天查询次数比例 decimal 0+ / null
120 all_query_cnt_ratio_3d_7d 全量口径‑近3天/近7天查询次数比例 decimal 0+ / null
121 all_query_cnt_ratio_7d_14d 全量口径‑近7天/近14天查询次数比例 decimal 0+ / null
122 all_query_cnt_ratio_3d_14d 全量口径‑近3天/近14天查询次数比例 decimal 0+ / null
123 all_query_cnt_ratio_7d_30d 全量口径‑近7天/近30天查询次数比例 decimal 0+ / null
124 all_query_avg_ratio_1d_3d 全量口径‑近1天日均/近3天日均查询次数比例 decimal 0+ / null
125 all_query_avg_ratio_3d_7d 全量口径‑近3天日均/近7天日均查询次数比例 decimal 0+ / null
126 all_query_avg_ratio_7d_14d 全量口径‑近7天日均/近14天日均查询次数比例 decimal 0+ / null
127 all_query_avg_ratio_3d_14d 全量口径‑近3天日均/近14天日均查询次数比例 decimal 0+ / null
128 all_query_avg_ratio_7d_30d 全量口径‑近7天日均/近30天日均查询次数比例 decimal 0+ / null
129 all_org_cnt_ratio_1d_3d 全量口径‑近1天/近3天查询机构数比例 decimal 0+ / null
130 all_org_cnt_ratio_3d_7d 全量口径‑近3天/近7天查询机构数比例 decimal 0+ / null
131 all_org_cnt_ratio_7d_14d 全量口径‑近7天/近14天查询机构数比例 decimal 0+ / null
132 all_org_cnt_ratio_3d_14d 全量口径‑近3天/近14天查询机构数比例 decimal 0+ / null
133 all_org_cnt_ratio_7d_30d 全量口径‑近7天/近30天查询机构数比例 decimal 0+ / null
134 all_org_avg_ratio_1d_3d 全量口径‑近1天日均/近3天日均查询机构数比例 decimal 0+ / null
135 all_org_avg_ratio_3d_7d 全量口径‑近3天日均/近7天日均查询机构数比例 decimal 0+ / null
136 all_org_avg_ratio_7d_14d 全量口径‑近7天日均/近14天日均查询机构数比例 decimal 0+ / null
137 all_org_avg_ratio_3d_14d 全量口径‑近3天日均/近14天日均查询机构数比例 decimal 0+ / null
138 all_org_avg_ratio_7d_30d 全量口径‑近7天日均/近30天日均查询机构数比例 decimal 0+ / null
139 cross_dev_face_cnt_7d 过去7日跨设备人脸验证次数 int 0+
140 cross_dev_face_cnt_30d 过去30日跨设备人脸验证次数 int 0+
141 cross_dev_face_cnt_90d 过去90日跨设备人脸验证次数 int 0+
142 face_dev_cnt_7d 过去7日人脸验证设备数量 int 0+
143 face_dev_cnt_30d 过去30日人脸验证设备数量 int 0+
144 face_dev_cnt_90d 过去90日人脸验证设备数量 int 0+
145 id_face_cnt_7d 近7天证件关联人脸数 int 0+
146 id_face_cnt_30d 近30天证件关联人脸数 int 0+
147 id_face_cnt_90d 近90天证件关联人脸数 int 0+
148 face_id_cnt_7d 近7天人脸关联证件数 int 0+
149 face_id_cnt_30d 近30天人脸关联证件数 int 0+
150 face_id_cnt_90d 近90天人脸关联证件数 int 0+
151 id_cross_face_org_cnt_30d 近30天证件跨人脸机构数 int 0+
152 id_cross_face_org_cnt_90d 近90天证件跨人脸机构数 int 0+
153 face_cross_id_org_cnt_30d 近30天人脸跨证件机构数 int 0+
154 face_cross_id_org_cnt_90d 近90天人脸跨证件机构数 int 0+
155 id_multi_face_flag 同一证件号90天是否关联多个不同人脸 int 0=否，1=是
156 face_multi_id_flag 同一人脸90天是否关联多个不同证件号 int 0=否，1=是
157 face_multi_device_flag 同一人脸90天是否关联多个不同设备 int 0=否，1=是

# 六、HTTP状态码

http状态码 错误信息 意义说明
200 正常值，服务器成功返回用户请求的数据
400 INVALID_IMAGE image超出2M
400 IMAGE_ERROR_UNSUPPORTED_FORMAT 上传的图像无法解析
400 FACE_NOT_FOUND 未找到对应数据
400 BAD_ARGUMENTS:<key> 某个参数解析出错(比如必须是数字，但是输入的是非数字字符串，或者长度过长)
400 MISSING_ARGUMENTS:<key> 缺少某个必选参数
403 AUTHENTICATION_ERROR 无效签名
403 AUTHENTICATION_ERROR:<reason> api_key被停用、调用次数超限、没有调用此API的权限，或者没有以当前方式调用此API的权限 <reason>取值:
- API_KEY_BE_DISCONTINUED:api_key被停用
- IP_NOT_ALLOWED:不允许访问的IP
- LIMIT_REACHED:测试api_key调用量已达到上限
- DENIED:无权限调用当前API
- EXPIRED_SIGN:签名已过期
- INVALID_SIGN:无效签名 其他可能的错误码
403 CONCURRENCY_LIMIT_EXCEEDED 并发数超过限制
404 API_NOT_FOUND 所调用的API不存在
500 INTERNAL_ERROR 如果持续出现此类错误，请及时联系客服或商务

# 七、示例代码

成功示例：

JSON
{
    "request_id": "1786415523,cc1a65c1-b7b9-483f-b349-019a94c8db24",
    "time_used": 487,
    "result": {
        "active_days_30d": 1,
        "active_days_7d": 1,
        "avg_query_interval_30d": 0,
        "avg_query_interval_7d": 0,
        "continuous_2d_multi_org_cnt_30d": 0,
        "continuous_2d_multi_org_cnt_7d": 0,
        "continuous_2d_query_cnt_30d": 0,
        "continuous_2d_query_cnt_7d": 0,
        "continuous_3d_multi_org_cnt_30d": 0,
        "continuous_3d_multi_org_cnt_7d": 0,
        "continuous_3d_query_cnt_30d": 0,
        "continuous_3d_query_cnt_7d": 0,
        "first_query_days": 2,
        "last_query_days": 2,
        "max_daily_query_cnt_30d": 3,
        "max_daily_query_cnt_7d": 3,
        "new_org_cnt_30d": 3,
        "new_org_cnt_7d": 3,
        "night_query_ratio_30d": 0,
        "night_query_ratio_7d": 0,
        "org_avg_ratio_1d_3d": 0,
        "org_avg_ratio_3d_14d": 4.666667,
        "org_avg_ratio_3d_7d": 2.333333,
        "org_avg_ratio_7d_14d": 2,
        "org_avg_ratio_7d_30d": 4.285714,
        "org_cnt_14d": 3,
        "org_cnt_1d": 0,
        "org_cnt_21d": 3,
        "org_cnt_30d": 3,
        "org_cnt_3d": 3,
        "org_cnt_7d": 3,
        "org_cnt_90d": 3,
        "org_cnt_ratio_1d_3d": 0,
        "org_cnt_ratio_3d_14d": 1,
        "org_cnt_ratio_3d_7d": 1,
        "org_cnt_ratio_7d_14d": 1,
        "org_cnt_ratio_7d_30d": 1,
        "query_avg_ratio_1d_3d": 0,
        "query_avg_ratio_3d_14d": 4.666667,
        "query_avg_ratio_3d_7d": 2.333333,
        "query_avg_ratio_7d_14d": 2,
        "query_avg_ratio_7d_30d": 4.285714,
        "query_cnt_14d": 3,
        "query_cnt_1d": 0,
        "query_cnt_21d": 3,
        "query_cnt_30d": 3,
        "query_cnt_3d": 3,
        "query_cnt_7d": 3,
        "query_cnt_90d": 3,
        "query_cnt_ratio_1d_3d": 0,
        "query_cnt_ratio_3d_14d": 1,
        "query_cnt_ratio_3d_7d": 1,
        "query_cnt_ratio_7d_14d": 1,
        "query_cnt_ratio_7d_30d": 1,
        "query_time_variance_30d": 0,
        "query_time_variance_7d": 0,
        "same_org_repeat_cnt_30d": 1,
        "same_org_repeat_cnt_7d": 1,
        "top1_org_query_ratio_30d": 0.333333,
        "top1_org_query_ratio_7d": 0.333333
    }
}

失败示例：

Plain
{
    "request_id": "1786415623,b14afd55-45ae-4fff-8418-3c403e5e2154",
    "time_used": 515,
    "error_message": "FACE_NOT_FOUND"
}
Copyright © 2026 原力金智（重庆）科技有限公司