国际手机号风险画像专业版

API 方式#

Base URL#

新加坡节点：https://sg.apitd.net/verification/persona/phone/pro/v1
美国节点：https://us.apitd.net/verification/persona/phone/pro/v1
德国节点：https://de.apitd.net/verification/persona/phone/pro/v1

API#

URL	请求方式	Content-Type	输出格式	字符集
api-base-url?partner_code=xxx&partner_key=xxx	POST	application/json	JSON	UTF-8

示例：https://sg.apitd.net/verification/persona/phone/pro/v1?partner_code=test_code&partner_key=test_key

认证参数

字段	类型	含义	建议	备注
partner_code	String	合作方标识	必须	由 TD 分配
partner_key	String	合作方密钥	必须	由 TD 分配

请求参数#

字段	类型	含义	建议	备注
country_code	Integer	国家区号	必须	符合国际电信联盟 E.164 标准，不含 + 号和前缀 0，如 86
phone_number	String	手机号 / 电话号码	必须	不含 + 号和前缀

请求示例#

JSON

{
    "country_code": 86,
    "phone_number": "18700001111"
}

响应参数#

字段	类型	含义	备注
code	Integer	API 状态码
message	String	状态信息	在 API 异常状态下会输出具体的异常原因
sequence_id	String	响应唯一码	用于跟踪每次请求记录的唯一标识
country_id	String	国家编码
country	String	国家
province	String	省份
city	String	城市
operator	String	运营商
phone_type	String	手机号类型	枚举值： fixed_line：固定电话 mobile：移动电话 prepaid：预付费移动电话 toll_free：免费电话 voip：网络电话 pager：寻呼机 payphone：公用电话 invalid：无效号码 restricted_premium：受限号码 personal：个人可转移电话 voicemail：语音信箱 other：其它
risk_score	Integer	风险分	范围为 0 - 100

API 状态码

code	含义
200	成功
301	未购买此服务
302	流量已被禁用
303	流量不足
304	服务已过期
305	日流量已封顶
9600	系统错误
9606	参数非法

响应示例#

JSON

{
  "code": 200,
  "message": "",
  "sequence_id": "1648777165770866F82AC7F326307055",
  "country_id": "CN",
  "country": "China",
  "province": "",
  "city": "Countrywide",
  "operator": "China Mobile",
  "phone_type": "mobile",
  "risk_score": 30

URL

请求方式

Content-Type

输出格式

字符集

api-base-url?partner_code=xxx&partner_key=xxx

POST

application/json

JSON

UTF-8

字段

类型

含义

建议

备注

partner_code

String

合作方标识

必须

由 TD 分配

partner_key

String

合作方密钥

必须

由 TD 分配

字段

类型

含义

建议

备注

country_code

Integer

国家区号

必须

符合国际电信联盟 E.164 标准，不含 + 号和前缀 0，如 86

phone_number

String

手机号 / 电话号码

必须

不含 + 号和前缀

字段

类型

含义

备注

code

Integer

API 状态码

message

String

状态信息

在 API 异常状态下会输出具体的异常原因

sequence_id

String

响应唯一码

用于跟踪每次请求记录的唯一标识

country_id

String

国家编码

country

String

国家

province

String

省份

city

String

城市

operator

String

运营商

phone_type

String

手机号类型

枚举值：
fixed_line：固定电话
mobile：移动电话
prepaid：预付费移动电话
toll_free：免费电话
voip：网络电话
pager：寻呼机
payphone：公用电话
invalid：无效号码
restricted_premium：受限号码
personal：个人可转移电话
voicemail：语音信箱
other：其它

risk_score

Integer

风险分

范围为 0 - 100

code

含义

200

成功

301

未购买此服务

302

流量已被禁用

303

流量不足

304

服务已过期

305

日流量已封顶

9600

系统错误

9606

参数非法

{ "code": 200, "message": "", "sequence_id": "1648777165770866F82AC7F326307055", "country_id": "CN", "country": "China", "province": "", "city": "Countrywide", "operator": "China Mobile", "phone_type": "mobile", "risk_score": 30