/data/verify_name_phone
1.接口描述
该API的功能是验证运营商二要素(姓名和手机号)是否匹配。
请求方式:
POST
请求URL:
https://cloudapi.deepfinch.com/data/verify_name_phone
调试工具
2.请求参数
2.1 请求头域
字段 | 类型 | 必需 | 描述 |
---|---|---|---|
X-DF-API-ID | string | 是 | API调用凭证信息,详细信息请参考API调用 |
X-DF-API-SECRET | string | 是 | API调用凭证信息,详细信息请参考API调用 |
2.2 请求体
字段 | 类型 | 必需 | 描述 |
---|---|---|---|
name | string | 是 | 姓名 |
phone_number | string | 是 | 手机号码 |
3.返回参数
正常响应 (200
)
字段 | 类型 | 描述 |
---|---|---|
request_id | string | 本次请求的 id |
status | string | 状态。正常为 OK ,其他值表示失败。详见错误码 |
state | int | 业务状态码 1: 查询成功,二要素一致 2: 查询成功,二要素不一致 3: 查询成功, 核验异常 |
carrier | string | 运营商: china_mobile 中国移动 china_union 中国联通 china_telecom 中国电信 other 未知 |
输出示例:
{
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e",
"status": "OK",
"state": 1,
"carrier": "china_union"
}
4.错误码
状态码 | status 字段 |
说明 |
---|---|---|
400 |
INVALID_ARGUMENT | 请求参数错误 |
400 |
QUERY_FAILED | 核验失败 |
401 |
UNAUTHORIZED | 未授权或授权失败 |
403 |
RATE_LIMIT_EXCEEDED | 调用频率超出限额 |
404 |
NOT_FOUND | 请求路径错误 |
500 |
INTERNAL_ERROR | 服务器内部错误 |
输出示例:
{
"status": "QUERY_FAILED",
"result_code": 9002,
"result_message": "参数为空或格式错误",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}