实时检测

实时检测回答的是关于一个标识的即时问题：这个手机号——或者这个邮箱——是否在某个平台注册过？

引擎和后台控制台用的是同一套。它接受手机号或邮箱，对 1 到 10 个实时产品做检测，每个产品返回一条结论。

什么时候用它

你的情况	用什么
只有一个标识，或几条，而且现在就要结果	实时检测
有成千上万条，可以等	批量检测

典型的实时场景：注册或下单时的表单校验、内部工具里的单次查询、已有流程里夹带的少量检测。批量为文件和长数组而生：异步执行、按实际检测的行数计价、完成后可下载结果。

两个系列，一套契约

系列写在路径里，并且必须和你选的产品一致：

系列	端点	identifier
手机号	POST /v1/realtime/check/phone	E.164 号码，例如 +8613800138000
邮箱	POST /v1/realtime/check/email	邮箱地址，例如 user@example.com

一次请求不能混用系列：同时选手机号产品和邮箱产品会被拒绝。country 对完整的 E.164 号码是可选的，而邮箱必须不带这个字段。

一次请求怎么算

一次调用 = 一个标识 × 1 到 10 个产品：

• 一个 request_id
• results 里每个产品一条
• 每条独立计费

因为每条单独结算，一次调用可能部分产品成功、部分失败。这种情况返回 status: partial_succeeded，每条结果带自己的 billing_status——请读这些字段，而不是只看 HTTP 200。

本节页面

• 手机号实时检测——手机号端点的完整说明
• 邮箱实时检测——邮箱端点的完整说明
• 实时产品列表——可选产品的实时清单，以及怎么读出 ID
• 幂等与重试——为什么 Idempotency-Key 是必填的，重试会怎样
• 计费与退款——哪些计费、哪些退款、什么时候发生
• cURL / SDK 示例——常见场景的可复制调用

发第一次请求之前

1. 准备一个 API Key，见认证。
2. 从实时产品列表读出你要用的产品 ID。
3. 每次调用都带一个唯一的 Idempotency-Key——这是必填项，不是可选项。