查询标签及基本信息
POST
/prism/external/queryTagAndInfo-20%0.1 USDT/次0.08 USDT/次免费计费说明:发生异常时不收取费用。
空结果计费说明:该接口每天最多提供 10 次免费空结果查询。
空结果定义:服务器查询结果为空,未找到任何数据。
通过 CURP、电子邮箱或电话号码查询公民标签及基本信息。
以下为完整的合成示例数据。请使用您有权查询的数据进行在线测试;在线测试显示接口实际返回结果。
开始使用这个接口
- 注册账号,或使用已有账号。
- 在「账号 → 安全」中复制 API Token。
- 在「在线测试」中输入 Token 和您有权查询的原始数据。脱敏示例仅用于说明格式,实际调用时须替换。
在线测试受账号测试额度和网关规则约束。正式调用前,请确认接口单价和可用余额。 查看余额与充值
请求头参数
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
X-Api-Token | string | 必填 | 您的平台 API 令牌 |
参数
| 名称 | 位置 | 类型 | 是否必填 | 示例 | 描述 |
|---|---|---|---|---|---|
hello-agent | query | string | 必填 | - | agent |
请求体示例
{
"secretKey": "fb4db743004087af5f63eb98568d284f415df64c9e9ac504770c20dc0845bca1",
"userName": "SAMPLE USER",
"eventCode": "query_tag_info",
"keyword": "TEST900101HDFABC01"
}响应 200JSON
{
"code": 0,
"msg": "OK",
"data": {
"userInfo": {
"TEST900101HDFABC01": {
"ext": {
"risk_accept_score": "45.416",
"job_stable_level": "28",
"credit_level": "1",
"risk_score_3_0": "57.049",
"risk_score_3_1": "39.386",
"repay_level": "3",
"risk_score_1": "65.353",
"salary_level": "27.847",
"apply_loan_level": "7",
"risk_score_2": "21.972",
"status_level": "3"
}
}
},
"tag": {
"TEST900101HDFABC01": [
{
"code": "is_whatsapp"
},
{
"code": "is_advanced_contact"
},
{
"code": "is_night_applicant_old"
},
{
"code": "is_facebook"
},
{
"code": "is_weekend_applicant_new"
},
{
"code": "is_stable_job"
},
{
"code": "is_overdue_30d_order"
},
{
"code": "is_high_salary"
},
{
"code": "is_weekend_applicant_old"
},
{
"code": "is_rejected_applicant"
}
]
}
}
}响应字段
| 名称 | 类型 | 含义 | 示例 | 描述 |
|---|---|---|---|---|
response | JSON | `[ { "name": "SAMPLE USER", "type": "string", "field_description": "身份风险等级", "field_value_example": "4", "description": "根据教育背景、社会保障缴费情况、子女相关状态及其他相关信号构建。数值越高,风险越高。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "薪资等级", "field_value_example": "11", "description": "根据社会保障记录中的日工资、现金贷记录中的薪资及其他相关信号构建。数值越高,风险越低。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "工作稳定性等级", "field_value_example": "27", "description": "根据工作天数、缴纳社会保障的雇主数量、居住类型及其他相关信号构建。数值越高,风险越低。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "还款能力等级", "field_value_example": "2", "description": "根据银行等级、银行存款、登记金融机构数量及其他相关信号构建。数值越高,风险越低。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "信用等级", "field_value_example": "0.514", "description": "根据过去 1 至 3 年的历史还款率、还款金额和还款订单数构建。数值越高,风险越低。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "贷款申请等级", "field_value_example": "3", "description": "根据过去 1 至 3 年登记的现金贷平台数量、最高申请频率、放款次数、重复借款次数及其他相关信号构建。数值越高,风险越高。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "风险接受度评分", "field_value_example": "20.399", "description": "根据过去 1 至 3 年登记的现金贷平台数量、利率、还款期限、申请金额及其他相关信号构建。数值越高,表示用户越偏向次级客群,风险接受度也越高。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "用户风险评分 V1", "field_value_example": "73.085", "description": "评估单期和 7 天短期产品的贷后行为。数值越高,风险越高。模型基础:GBDT + LR。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "用户风险评分 V2", "field_value_example": "27.314", "description": "评估分期及 14 至 30 天中期产品的贷后行为。数值越高,风险越高。模型基础:GBDT + LR。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "用户风险评分 V3,第 0 分群", "field_value_example": "58.917", "description": "评估分期及 30 天以上中长期产品的贷后行为。数值越高,风险越高。模型基础:GBDT + LR。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "用户风险评分 V3,第 1 分群", "field_value_example": "50.396", "description": "评估分期及 30 天以上中长期产品的贷后行为。数值越高,风险越高。模型基础:GBDT + LR。" } ]` | - | `[ { "name": "SAMPLE USER", "type": "string", "field_description": "身份风险等级", "field_value_example": "4", "description": "根据教育背景、社会保障缴费情况、子女相关状态及其他相关信号构建。数值越高,风险越高。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "薪资等级", "field_value_example": "11", "description": "根据社会保障记录中的日工资、现金贷记录中的薪资及其他相关信号构建。数值越高,风险越低。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "工作稳定性等级", "field_value_example": "27", "description": "根据工作天数、缴纳社会保障的雇主数量、居住类型及其他相关信号构建。数值越高,风险越低。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "还款能力等级", "field_value_example": "2", "description": "根据银行等级、银行存款、登记金融机构数量及其他相关信号构建。数值越高,风险越低。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "信用等级", "field_value_example": "0.514", "description": "根据过去 1 至 3 年的历史还款率、还款金额和还款订单数构建。数值越高,风险越低。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "贷款申请等级", "field_value_example": "3", "description": "根据过去 1 至 3 年登记的现金贷平台数量、最高申请频率、放款次数、重复借款次数及其他相关信号构建。数值越高,风险越高。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "风险接受度评分", "field_value_example": "20.399", "description": "根据过去 1 至 3 年登记的现金贷平台数量、利率、还款期限、申请金额及其他相关信号构建。数值越高,表示用户越偏向次级客群,风险接受度也越高。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "用户风险评分 V1", "field_value_example": "73.085", "description": "评估单期和 7 天短期产品的贷后行为。数值越高,风险越高。模型基础:GBDT + LR。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "用户风险评分 V2", "field_value_example": "27.314", "description": "评估分期及 14 至 30 天中期产品的贷后行为。数值越高,风险越高。模型基础:GBDT + LR。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "用户风险评分 V3,第 0 分群", "field_value_example": "58.917", "description": "评估分期及 30 天以上中长期产品的贷后行为。数值越高,风险越高。模型基础:GBDT + LR。" }, { "name": "SAMPLE USER", "type": "string", "field_description": "用户风险评分 V3,第 1 分群", "field_value_example": "50.396", "description": "评估分期及 30 天以上中长期产品的贷后行为。数值越高,风险越高。模型基础:GBDT + LR。" } ]` |
数据来源
本接口的上游持有方尚未确认。在确认之前,请勿将其用于合规敏感的决策。
速率限制与免费额度
- 每秒请求数上限
- 10
- 每日免费空结果次数
- 10
未命中记录的调用在此额度内不计费。超出后,空结果按单价计费。
扣费发生在调用当时。余额不足时网关返回 402,且不会发起调用。
错误码
以下是生产环境实际观测到的状态码及其处理方式。未列出的状态码尚未出现过。
| 状态码 | 含义与处理方式 |
|---|---|
200 | 请求已到达上游并有响应返回。其中包含“查无记录”的情形,因此要看载荷内容,不能只看状态码。 |
402 | 预付余额不足以支付本次调用。调用未发起,也未扣费。充值后重试。 |
504 | 上游未在时限内响应。请稍后重试;对慢速登记机构而言这是正常的失败形态。 |
404 | 路由不存在,或该接口已下线。 |
401 | API token 缺失或无效。 |
使用条件
本接口返回的是由国家登记机构或机构持有的、关于可识别个人的个人数据。你必须对查询的每一个标识符具备合法依据,不得遍历标识符区间,也不得将结果作为对他人作出不利决定的唯一依据。
墨西哥实时数据综合 API