API REFERENCE

全网在网状态核验接口

原始 PDF

实时核查手机号码的在网状态,覆盖移动、联通、电信、广电四大运营商,可识别正常、关机、空号、停机等多种状态,并支持携号转网识别。

POST
拉美地区http://mxg.mnemodata.com/gateway/verify/status
东南亚地区http://ph.mnemodata.com/gateway/verify/status

输入参数列表

输入参数列表
参数名类型说明
memberCode必填String
商户号
接口平台开通的商户号
terminalCode必填String
终端号
接口平台开通的终端号
signData必填String
加密参数
对业务参数加密后的字符串,详见 signData 说明

signData 加密参数

以下参数需在客户端按约定加密算法加密后,作为 signData 字段的值传入。

signData 加密参数
参数名类型说明
memberCode必填String
商户号
接口平台开通的商户号
terminalCode必填String
终端号
接口平台开通的终端号
memberOrder必填String
商户订单号
最大 50 位,每次请求不可重复,用于双方订单核实
subMemberDesc必填String
直接授权商户名
需为与查询用户直接签订授权协议的公司工商登记名称
phone必填String
手机号
MD5 小写 32 位加密

返回参数列表

返回参数列表
参数名类型说明
successboolean
请求成功标识
true: 请求成功;false: 请求失败
errorCodeString
状态码
详见公共状态码,success 为 true 时返回 null
errorMsgString
状态描述
详见公共状态码,success 为 true 时返回 null
dataObject
结果数据
包含交易结果及业务详情

data 字段说明

data 字段说明
参数名类型说明
codeString
交易结果编码
业务状态码,详见各接口 code 状态表
tradeNoString
交易订单号
系统生成的本次交易唯一流水号
descString
交易结果描述
对 code 的文字说明
feeString
收费标识
Y: 本次查询计费;N: 本次查询不计费
detailObject
业务详情
具体筛查结果,字段因接口而异,详见各接口 detail 说明

detail 筛查结果字段

detail 筛查结果字段
参数名类型说明
resultString
核验结果
1=正常 | 2=空号 | 3=通话中 | 4=不在网 | 5=关机 | 6=疑似关机 | 8=停机
messageString
核验结果描述
对 result 字段的中文解释,如"正常"、"关机"等
is_xhzwString
是否携号转网
1: 是;0: 否
operatorString
号码归属运营商
1=移动 | 2=联通 | 3=电信 | 4=广电(号段归属)
operator_realString
实际接入运营商
1=移动 | 2=联通 | 3=电信 | 4=广电(携号转网后的实际运营商)

code 验证状态表

code 验证状态表
code收费描述
0计费成功
1免费查无结果
999免费渠道异常