实时产品列表
实时接口用数字 ID 指定产品,批量接口用slug。两者不通用:把 ID 填进批量请求、或把 slug 填进实时请求,都会被拒绝。
下表在每次站点构建时从线上产品目录重新生成,所以它和 GET /v1/products 返回的内容始终一致。
这些数字 ID 填在
product_ids 里。实时接口只接受 ID —— 批量表中的 slug 在这里无效。一次请求只能选择同一系列的产品。| 产品名称 | 模式 | 调用标识 | 最低数量 |
|---|---|---|---|
| Amazon 注册检测 | 单次(实时) | #53 | 1 |
| Amazon 邮箱检测 | 单次(实时) | #54 | 1 |
| Apple ID 注册检测 | 单次(实时) | #57 | 1 |
| Apple ID 邮箱检测 | 单次(实时) | #58 | 1 |
| BAND 注册检测 | 单次(实时) | #60 | 1 |
| Facebook 注册检测 | 单次(实时) | #51 | 1 |
| Facebook 邮箱检测 | 单次(实时) | #52 | 1 |
| Instagram 注册检测 | 单次(实时) | #48 | 1 |
| Instagram 邮箱检测 | 单次(实时) | #49 | 1 |
| Microsoft 注册检测 | 单次(实时) | #59 | 1 |
| Telegram 注册检测 | 单次(实时) | #50 | 1 |
| Viber 注册检测 | 单次(实时) | #55 | 1 |
| WhatsApp 注册检测 | 单次(实时) | #47 | 1 |
| X(原 Twitter)注册检测 | 单次(实时) | #61 | 1 |
本表在每次站点构建时自动从线上产品目录同步。
怎么从这个表读出 ID
Section titled “怎么从这个表读出 ID”# 那一列就是你要传的值。对实时产品来说,它就是 GET /v1/products 里的 id。
{ "product_ids": [49] }上表的 ID 是当前值。产品会陆续新增和下架,所以请把本页——而不是从别处抄来的示例——当作权威来源。
两个系列,不能混
Section titled “两个系列,不能混”每个实时产品属于 phone 或 email 系列,一次请求只能选择同一个系列的产品:
- 手机号调用(
/v1/realtime/check/phone)传手机号产品 ID - 邮箱调用(
/v1/realtime/check/email)传邮箱产品 ID
混在一起会被判为无效的实时请求。这条规则来自被校验的对象本身:手机号有国家、邮箱没有,两者无法共用一次校验。
一次调用可以传 1 到 10 个 ID。每个产品在 results 中产生独立一条,并独立计费,全部挂在同一个 request_id 下:
{ "product_ids": [49, 52, 54] }超过 10 个会返回 invalid_realtime_request。要对同一个标识做超过 10 项检测,就发多次请求——每次用各自的 Idempotency-Key。
价格从哪里来
Section titled “价格从哪里来”每个产品按自己的单次价格计费,命中结果缓存时同样计费。产品目录接口有意不暴露任何定价——GET /v1/products 只返回 id、slug、name、name_translations、mode、series 和 min_phones。当前价格请到账户内的价格页面查看。
具体哪些结果计费、哪些退款,见计费与退款。