跳转到内容

实时产品列表

实时接口用数字 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

本表在每次站点构建时自动从线上产品目录同步。

# 那一列就是你要传的值。对实时产品来说,它就是 GET /v1/products 里的 id。

{ "product_ids": [49] }

上表的 ID 是当前值。产品会陆续新增和下架,所以请把本页——而不是从别处抄来的示例——当作权威来源。

每个实时产品属于 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。

每个产品按自己的单次价格计费,命中结果缓存时同样计费。产品目录接口有意不暴露任何定价——GET /v1/products 只返回 id、slug、name、name_translations、mode、series 和 min_phones。当前价格请到账户内的价格页面查看。

具体哪些结果计费、哪些退款,见计费与退款。