API REFERENCE

电子邮箱风控检测接口

原始 PDF

检测电子邮箱的风险评分、地址与域名有效性、互联网平台注册情况、联盟网络欺诈历史、数据泄露记录及关联域名注册信息。

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

输入参数列表

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

signData 加密参数

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

signData 加密参数
参数名类型说明
memberCode必填String
商户号
接口平台开通的商户号；原文未注明类型
terminalCode必填String
终端号
接口平台开通的终端号；原文未注明类型
memberOrder必填String
商户订单号
最大 50 位且每次不能重复；该字段是双方订单核实的唯一字段，需保存；原文未注明类型
subMemberDesc必填String
直接授权商户名称
需为与查询用户直接签订授权协议的公司主体的工商登记名称；原文未注明类型
email必填String
完整电子邮箱地址
示例：example@example.com；区分大小写，不能包含空格，必须符合邮箱基本格式；原文未注明类型
username必填String
商户名
接口平台开通的商户名；原文未注明类型

返回参数列表

返回参数列表
参数名类型说明
successboolean
请求成功标识
true：网关正常处理；false：请求失败
dataobject
交易结果
包含交易结果及筛查详情
errorCodeString
状态码
success 为 true 时返回 null；失败时详见公共状态码
errorMsgString
状态描述
success 为 true 时返回 null；失败时详见公共状态码

data 字段说明

data 字段说明
参数名类型说明
codestring
交易结果编码
详见本接口 code 状态表
descstring
交易结果描述
tradeNostring
平台交易订单号
用于订单追踪和对账
feestring
收费标识
Y：收费；N：不收费
detailobject
筛查结果详情
具体筛查结果，详见 detail 字段说明

detail 筛查结果字段

detail 筛查结果字段
参数名类型说明
idstring
邮箱检测唯一标识
本次 Mnemo 邮箱检测的唯一标识
emailstring
完整电子邮箱地址
本次检测的完整电子邮箱地址
risk_scoresobject
风险评分集合
risk_scores.global_network_scorenumber
Mnemo 全局网络风险评分
email_detailsobject
邮箱详情
邮箱本身的有效性、活跃度及随机性信息
email_details.deliverableboolean
邮件是否可投递
数据不可用时可能不返回或为 null
email_details.full_inboxboolean
邮箱收件箱是否已满
数据不可用时可能不返回或为 null
email_details.valid_formatboolean
邮箱地址格式是否有效
email_details.minimum_age_monthsint32
邮箱最小使用月数
根据最早数字足迹估算
email_details.earliest_profile_datedatetime
最早注册资料时间
发现该邮箱最早注册资料的时间
email_details.email_randomness_scorenumber
邮箱名称随机性评分
数值越高通常表示随机性越强
email_domain_detailsobject
邮箱域名详情
邮箱域名、DNS、安全策略和注册信息
email_domain_details.accept_allboolean
是否接受任意地址邮件
域名邮件服务器是否接受发送到任意地址的邮件
email_domain_details.createddatetime
域名注册时间
email_domain_details.customboolean
是否为自定义/企业邮箱域名
email_domain_details.disposableboolean
是否为一次性临时邮箱域名
email_domain_details.dmarc_enforcedboolean
是否执行 DMARC 邮件认证策略
email_domain_details.domainstring
邮箱域名
email_domain_details.expiresdatetime
域名注册到期时间
email_domain_details.freeboolean
是否为免费邮箱服务商
email_domain_details.registeredboolean
域名是否已注册
email_domain_details.registered_tostring
域名注册主体
email_domain_details.registrar_namestring
域名注册商名称
email_domain_details.spf_strictboolean
是否配置严格的 SPF 策略
email_domain_details.suspicious_tldboolean
是否使用高风险或可疑顶级域名
email_domain_details.tldstring
顶级域名
例如 .com
email_domain_details.updateddatetime
域名注册信息最近更新时间
email_domain_details.valid_mxboolean
是否存在有效 MX 邮件交换记录
email_domain_details.website_existsboolean
域名对应的网站是否存在
account_aggregatesobject
账号注册聚合信息
邮箱在各类互联网平台上的账号注册聚合信息
account_aggregates.total_registrationint32
账号注册总数
检测到的账号注册总数
account_aggregates.businessobject
商业类平台账号注册聚合信息
account_aggregates.business.total_registrationint32
商业类平台注册总数
account_aggregates.business.technologyobject
科技类平台聚合信息
包含 registered 和 checked
account_aggregates.business.technology.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.business.technology.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.business.science_and_educationobject
科研与教育类平台聚合信息
包含 registered 和 checked
account_aggregates.business.science_and_education.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.business.science_and_education.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.business.jobs_and_employmentobject
招聘与就业类平台聚合信息
包含 registered 和 checked
account_aggregates.business.jobs_and_employment.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.business.jobs_and_employment.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.business.money_transfer_remittanceobject
转账与汇款类平台聚合信息
包含 registered 和 checked
account_aggregates.business.money_transfer_remittance.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.business.money_transfer_remittance.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personalobject
个人类平台账号注册聚合信息
account_aggregates.personal.total_registrationint32
个人类平台注册总数
account_aggregates.personal.email_serviceobject
电子邮箱服务平台聚合信息
包含 registered 和 checked
account_aggregates.personal.email_service.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.email_service.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.betting_and_gamingobject
博彩与游戏类平台聚合信息
包含 registered 和 checked
account_aggregates.personal.betting_and_gaming.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.betting_and_gaming.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.datingobject
交友类平台聚合信息
包含 registered 和 checked
account_aggregates.personal.dating.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.dating.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.real_estateobject
房地产类平台聚合信息
包含 registered 和 checked
account_aggregates.personal.real_estate.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.real_estate.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.technologyobject
科技类平台聚合信息
包含 registered 和 checked
account_aggregates.personal.technology.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.technology.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.adult_sitesobject
成人网站聚合信息
包含 registered 和 checked
account_aggregates.personal.adult_sites.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.adult_sites.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.deliveryobject
配送服务平台聚合信息
包含 registered 和 checked
account_aggregates.personal.delivery.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.delivery.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.ecommerceobject
电子商务平台聚合信息
包含 registered 和 checked
account_aggregates.personal.ecommerce.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.ecommerce.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.entertainmentobject
娱乐平台聚合信息
包含 registered 和 checked
account_aggregates.personal.entertainment.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.entertainment.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.ai_platformsobject
人工智能平台聚合信息
包含 registered 和 checked
account_aggregates.personal.ai_platforms.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.ai_platforms.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.messengerobject
即时通讯平台聚合信息
包含 registered 和 checked
account_aggregates.personal.messenger.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.messenger.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.social_mediaobject
社交媒体平台聚合信息
包含 registered 和 checked
account_aggregates.personal.social_media.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.social_media.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
account_aggregates.personal.travelobject
旅行服务平台聚合信息
包含 registered 和 checked
account_aggregates.personal.travel.registeredint32
已注册账号/平台数量
在该类别已发现注册的账号/平台数量
account_aggregates.personal.travel.checkedint32
已检测平台数量
该类别实际完成检测的平台数量
mnemo_fraud_historyobject
联盟网络欺诈历史
mnemo_fraud_history.fraudulent_decline_first_seenint64
首次发现欺诈拒绝事件的时间
Unix 时间戳（秒）
mnemo_fraud_history.fraudulent_decline_last_seenint64
最近一次发现欺诈拒绝事件的时间
Unix 时间戳（秒）
mnemo_fraud_history.fraudulent_decline_customer_hitsint32
当前客户欺诈拒绝命中次数
当前客户范围内欺诈拒绝命中次数
mnemo_fraud_history.fraudulent_decline_hitsint32
联盟欺诈拒绝命中次数
联盟网络范围内欺诈拒绝命中次数
mnemo_fraud_history.first_seenint64
联盟网络首次发现该邮箱的时间
Unix 时间戳（秒）
mnemo_fraud_history.last_seenint64
联盟网络最近发现该邮箱的时间
Unix 时间戳（秒）
mnemo_fraud_history.customer_hitsint32
当前客户该邮箱的历史命中次数
mnemo_fraud_history.hitsint32
联盟网络该邮箱的历史命中次数
mnemo_fraud_history.flagsarray[string]
联盟风险标记列表
与该邮箱相关的联盟风险标记列表
breach_detailsobject
邮箱数据泄露记录汇总
breach_details.breachesarray[object]
数据泄露事件列表
breach_details.breaches[].datedate
泄露事件日期
breach_details.breaches[].domainstring
发生泄露的平台域名
breach_details.breaches[].namestring
泄露事件或平台名称
breach_details.first_breachdate
最早一次泄露事件日期
breach_details.last_breachdate
最近一次泄露事件日期
breach_details.haveibeenpwned_listedboolean
是否被 Have I Been Pwned 收录
breach_details.number_of_breachesint32
数据泄露事件数量
associated_domain_registrationsobject
关联域名注册信息
与邮箱持有人关联的域名注册信息
associated_domain_registrations.existsboolean
是否存在关联域名注册记录
associated_domain_registrations.number_of_domainsint32
关联域名数量
associated_domain_registrations.domainsarray[object]
关联域名详情列表
associated_domain_registrations.domains[].domain_namestring
关联域名名称
associated_domain_registrations.domains[].create_datedatetime
域名创建时间
associated_domain_registrations.domains[].update_datedatetime
域名信息更新时间
associated_domain_registrations.domains[].expiry_datedatetime
域名到期时间
associated_domain_registrations.domains[].registrar_namestring
域名注册商
associated_domain_registrations.domains[].full_namestring
域名注册人姓名
associated_domain_registrations.domains[].company_namestring
域名注册公司名称
associated_domain_registrations.domains[].mailing_addressstring
域名注册邮寄地址
associated_domain_registrations.domains[].city_namestring
域名注册城市
associated_domain_registrations.domains[].state_namestring
域名注册州/省
associated_domain_registrations.domains[].zip_codestring
域名注册邮政编码
associated_domain_registrations.domains[].country_codestring
域名注册国家/地区代码
associated_domain_registrations.domains[].phone_numberstring
域名注册联系电话
associated_domain_registrations.first_registration_datedatetime
最早关联域名注册时间

code 验证状态表

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