健康检查

服务存活探测

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/email/ping JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息，固定为 pong
data	object	业务数据
data.version	string	服务版本号
data.time	string	服务器当前时间（格式 Y-m-d H:i:s）

请求示例

返回示例

{"msg":"pong","code":200,"data":{"time":"2026-10-24 20:24:00","version":"1.0"}}

邮箱检测

检测单个邮箱（格式、临时邮箱、角色账号、MX、风险评分）

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

POST http://www.shujuyu.cn/v1/api/email/verify JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
email	string	是	待检测的邮箱地址（最长 254 字符）；格式非法时仍返回 200，并在 data 中给出 is_valid_format=false 与 format_error
check_mx	boolean	否	是否校验 MX 记录，默认 true；传 0/false/no/off 可关闭

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.email	string	邮箱地址
data.local_part	string	邮箱 @ 前的部分，格式非法时为空字符串
data.domain	string	邮箱域名，格式非法时为空字符串
data.is_valid_format	boolean	邮箱格式是否有效
data.is_disposable	boolean	是否为一次性（临时）邮箱
data.is_role_account	boolean	是否为角色账号（如 admin/info 等）
data.format_error	string	格式非法时返回错误原因（missing_at_sign/invalid_local_chars/domain_missing_dot 等），格式合法时不返回该字段
data.mx_records	array	MX 记录列表，无记录或未查询时为空数组
data.mx_valid	boolean	MX 记录是否有效；格式非法时该字段为 null
data.mx_skipped	boolean	是否跳过 MX 校验（已知合法域名会跳过查询）
data.risk_score	integer	风险评分（0-100）
data.risk_level	string	风险等级：low/medium/high/block
data.hit_rules	array	命中的检测规则列表
data.hit_rules[]	string	单条命中规则（如 invalid_format/disposable_domain_blacklist/domain_keyword:xxx/role_account/no_mx_record/mx_valid/mx_skipped_legitimate/format_pass）
data.suggestion	string	拼写纠错建议，无建议时为 null

请求示例

返回示例

{"msg":"success","code":200,"data":{"email":"test@qq.com","domain":"qq.com","mx_valid":true,"hit_rules":["role_account","mx_skipped_legitimate"],"local_part":"test","mx_records":[],"mx_skipped":true,"risk_level":"low","risk_score":15,"suggestion":null,"is_disposable":false,"is_role_account":true,"is_valid_format":true}}

批量检测

批量检测最多 10 个邮箱

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

POST http://www.shujuyu.cn/v1/api/email/verify-batch JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
emails	array	是	待检测的邮箱数组，最多 10 个，超出返回 4002
check_mx	boolean	否	是否校验 MX 记录，默认 true；传 0/false/no/off 可关闭

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	提交的邮箱总数
data.returned	integer	本次实际返回条数
data.valid	integer	格式有效且非临时邮箱的数量
data.disposable	integer	判定为临时邮箱的数量
data.invalid_format	integer	格式无效的数量
data.max_score	integer	本次结果中的最高风险分
data.max_level	string	本次结果中的最高风险等级
data.level_counts	object	各风险等级数量统计
data.level_counts.low	integer	低风险数量
data.level_counts.medium	integer	中风险数量
data.level_counts.high	integer	高风险数量
data.level_counts.block	integer	拦截级数量
data.truncated	boolean	保留字段，当前恒为 false（超过 10 条时直接返回 4002 错误，不会截断）
data.max_limit	integer	单次允许返回的最大条数
data.list	array	检测结果列表
data.list[]	object	列表中的单条检测记录
data.list[].email	string	邮箱地址
data.list[].local_part	string	邮箱 @ 前的部分
data.list[].domain	string	邮箱域名
data.list[].is_valid_format	boolean	邮箱格式是否有效
data.list[].is_disposable	boolean	是否为一次性（临时）邮箱
data.list[].is_role_account	boolean	是否为角色账号
data.list[].format_error	string	格式非法时返回错误原因，格式合法时不返回该字段
data.list[].mx_records	array	MX 记录列表，无记录或未查询时为空数组
data.list[].mx_valid	boolean	MX 记录是否有效；格式非法时该字段为 null
data.list[].mx_skipped	boolean	是否跳过 MX 校验（已知合法域名会跳过查询）
data.list[].risk_score	integer	风险评分（0-100）
data.list[].risk_level	string	风险等级：low/medium/high/block
data.list[].hit_rules	array	命中的检测规则列表
data.list[].hit_rules[]	string	单条命中规则
data.list[].suggestion	string	拼写纠错建议，无建议时为 null
data.list[].mx_records[]	string	MX 主机名

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"email":"a@gmail.com","domain":"gmail.com","mx_valid":true,"hit_rules":["mx_skipped_legitimate"],"local_part":"a","mx_records":[],"mx_skipped":true,"risk_level":"low","risk_score":0,"suggestion":null,"is_disposable":false,"is_role_account":false,"is_valid_format":true},{"email":"b@yopmail.com","domain":"yopmail.com","mx_valid":true,"hit_rules":["disposable_domain_blacklist","domain_keyword:yopmail","mx_valid"],"local_part":"b","mx_records":["smtp.yopmail.com"],"mx_skipped":false,"risk_level":"block","risk_score":90,"suggestion":null,"is_disposable":true,"is_role_account":false,"is_valid_format":true},{"email":"admin@example.com","domain":"example.com","mx_valid":true,"hit_rules":["role_account","mx_valid"],"local_part":"admin","mx_records":[],"mx_skipped":false,"risk_level":"low","risk_score":15,"suggestion":null,"is_disposable":false,"is_role_account":true,"is_valid_format":true}],"total":3,"valid":2,"returned":3,"max_level":"block","max_limit":10,"max_score":90,"truncated":false,"disposable":1,"level_counts":{"low":2,"high":0,"block":1,"medium":0},"invalid_format":0}}

产品说明

产品概述

检测邮箱是否为临时/一次性邮箱，支持批量检测。

使用场景

数据查询：快速集成临时邮箱检测到您的应用中

业务系统：将临时邮箱检测数据嵌入业务流程

开发工具：通过 API 接口获取数据查询数据

数据分析：基于临时邮箱检测数据进行分析和决策

费用计算

按次计费单价

¥0.002 / 次

每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣

扣费优先级

免费额度

次数包

余额扣费

计费方式详解

1 免费额度

· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。

2 次数包

预付费购买固定调用次数，最高可省 20%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。

3 余额扣费

按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：个人版9折专业版8折企业版7折
量折扣：月付费调用 ≥1000 次享 2%、月付费调用 ≥10000 次享 5%、月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。

次数包方案

方案名称	调用次数	价格	折算单价	比按次付费节省	有效期
100次调用包	100 次	¥0.2	¥0.0020/次	-	365 天
500次调用包	500 次	¥0.95	¥0.0019/次	省5%	365 天
1000次调用包	1000 次	¥1.8	¥0.0018/次	省10%	365 天
5000次调用包	5000 次	¥8.5	¥0.0017/次	省15%	365 天
10000次调用包	10000 次	¥16	¥0.0016/次	省20%	365 天

VIP 权益对比

等级	每月免费次数	本接口月免费上限	折扣	VIP 折后单价
免费版	按接口配置	—	-	¥0.002/次
个人版	5000 次	5000 次	10%	¥0.0018/次
专业版	30000 次	30000 次	20%	¥0.0016/次
企业版推荐	200000 次	200000 次	30%	¥0.0014/次

* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。

费用计算示例

* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。

示例1：普通用户按次付费

调用 1000 次，费用 = 0.002 × 1000 = ¥2.00

示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）

调用 1000 次，折扣约 10%，费用 = 0.002 × (1 - 10%) × 1000 ≈ ¥1.80

示例3：购买「500次调用包」次数包

支付 ¥0.95，获得 500 次调用，折算单价 ¥0.0019/次

同等次数按次付费需 ¥1.00，次数包可节省 ¥0.05

错误码说明

错误码	说明	解决方案
200	请求成功	-
400000	请求参数错误	检查参数名、格式与取值
401000	认证失败	检查 Authorization: Bearer 密钥是否正确、是否过期
402000	账户余额不足	充值后重试
403000	无访问权限	确认密钥权限、接口范围与 IP 白名单是否满足要求
404001	接口或端点不存在	检查 API 与端点的请求路径
409000	请求冲突	请稍后重试
422000	参数校验失败	检查参数格式与取值
429000	请求频率或额度超限	降低调用频率，或升级套餐提升额度
500000	服务器内部错误	携带响应中的 request_id 联系技术支持
502000	服务暂时不可用	稍后重试
503000	服务暂时不可用	稍后重试
504000	请求超时	稍后重试

更新日志

暂无更新日志