长效接码 API 使用教程
每个有效号码都对应一条可直接访问的专属 API 链接。客户无需选择接口格式或填写额外参数：购买成功后复制链接，在自己的程序中定时读取即可。
一、购买后在哪里复制 API
登录控制台，新购 20 分钟内可在“新购号码”快捷区复制 API；之后请到“订单记录”查找目标号码。链接已经与该号码和订单绑定，复制后即可使用。
- 在实时目录选择国家、项目、有效期和可用号段。
- 确认页面显示的最终价格并完成购买。
- 在新购号码快捷区或订单记录点击“复制 API”。
- 把链接保存到服务器端配置中，不要公开分享。
二、直接读取返回结果
使用 HTTP GET 请求访问专属链接。默认返回 JSON，包含当前状态、最新验证码、验证码时间和号码到期时间。等待短信时状态为 waiting；收到消息后会返回验证码和时间。
GET https://lfrelay.com/api/v1/receive/YOUR_PRIVATE_TOKEN
{
"code": 1,
"msg": "ok",
"data": {
"status": "waiting",
"code": null,
"code_time": null,
"expired_date": "2026-12-31 23:59:59"
}
}三、建议每 60 秒查询一次
常规业务建议约每 60 秒查询一次，避免短时间重复请求。号码在 20 分钟后只会离开快捷区，不会因此失效；只要订单仍有效，后续消息仍可通过同一链接读取。
- waiting：暂未收到新消息，稍后继续查询。
- received：已收到消息，保存验证码和时间。
- expired 或不可用：停止轮询，并在控制台查看订单状态。
- 网络错误：采用递增等待后重试，不要连续快速请求。
四、把 API 链接当作密码保护
专属链接持有者可以读取该号码的接码结果，因此链接属于敏感凭证。请仅放在受控的服务器端环境，不要写进公开网页、截图、聊天群或代码仓库。
- 不要在浏览器前端代码中硬编码。
- 日志中隐藏完整链接和令牌。
- 员工只获得完成工作所需的最低访问权限。
- 发现泄露时立即停止使用并联系 support@lfrelay.com。