SV Number 是做什么的？

你是一个AI助手。SV Number 为你租用一个真实电话号码，时间仅够一次注册。你选择国家和服务，号码专属于你，验证码通过API到达，用完你便归还。如果验证码始终未到，你可以取消，资金将退还到余额。

基础URL: https://sms-verification-number.com/stubs/handler_api
文档: sms-verification-number.com/en/api-sms-activate
人工控制台: sms-verification-number.com

开始之前

有两种场景。请确认你处于哪一种：

你已拥有API密钥。它可能已存储在环境变量 SVN_API_KEY 中，或者你的用户之前已提供过。请跳转到快速开始。
你还没有密钥。你的用户在 sms-verification-number.com/en/register 注册账号，充值余额，然后从个人资料复制密钥。请向他们索要密钥，然后将其存储在环境变量中，绝不要放在聊天记录或提交到代码文件里。

此API没有免费层级：每个号码都要花钱，因此有资金的余额是前提条件。在计划任何工作前，先用 getBalance 检查余额。

工作原理

一个号码 = 一次激活 = 一个服务。生命周期很短，且始终遵循相同流程：

选择国家 + 服务
        │
        ▼
   getNumber ──────────────► ACCESS_NUMBER:id:phone   (资金被冻结)
        │
        ▼
   将电话号码提供给你要注册的服务
        │
        ▼
   getStatus (轮询) ───────► STATUS_WAIT_CODE … STATUS_OK:123456
        │                                    │
        │ 验证码未到                       │ 验证码已到
        ▼                                    ▼
   setStatus 8 (取消)              setStatus 6 (完成)
   资金退回                           激活关闭

号码有效期为20分钟。之后激活会自动过期，针对其ID的任何调用都会返回 NO_ACTIVATION。规划好整个流程：拿到号码后立即向目标服务请求验证码，不要等十分钟。

每个请求都需要 lang 参数。它同时设置返回的语言和货币：en = 美元，ru = 卢布。它必须与你账户余额的货币一致，否则你看到的价格并非实际支付的价格。

GET 和 POST 请求均可。以下所有示例为清晰起见均使用 GET。

快速开始

将 APIKEY 替换为你的真实密钥。

第一步：检查余额

curl 'https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getBalance&lang=en'
# → 463.02

返回一个纯数字，这就是你以 lang 对应货币表示的余额。

第二步：查找国家和服务代码

国家及其运营商：

curl 'https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getCountryAndOperators&lang=en'
# → [{"id":2,"name":"Russia","operators":{"any":"any","tele2":"tele2",...}}, ...]

服务代码、价格、当前在线号码数量，以及最值得关注的字段——其他用户实际收到的短信比例：

curl 'https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getServicesAndCostWithStatistics&country=6&lang=en'
# → [{"id":"tg","name":"Telegram","price":0.71,"quantity":1429,"deliverability":"25.82",
#      "cheap_prices_countries":[{"country_id":6,"country_name":"Indonesia","price":"0.20"}, ...]}]

deliverability 是你的方向盘：验证码80%时间能到达的国家，比便宜三分钱但成功率只有一半的国家更有价值。cheap_prices_countries 告诉你同一个服务在哪些国家费用最低，当你要注册的服务不限制国家时可以使用它。

第三步：订购号码

curl 'https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getNumber&service=tg&country=6&operator=any&maxPrice=1.50&lang=en'
# → ACCESS_NUMBER:234242:79991728822

回复格式为 ACCESS_NUMBER:ID:PHONE。保存这个ID：之后的每次调用都会用到它。电话号码带国家代码，但没有 +；当你将其输入注册表单时，请自行添加 +。

maxPrice 是可选的，但值得设置：价格随需求浮动，它可以防止你在不知不觉中支付过高费用。如果上限过低，会返回 WRONG_MAX_PRICE:13.21，其中数字是当前最低价格。

喜欢 JSON 格式？getNumberV2 使用相同的参数，并以对象形式返回结果（activationId、phoneNumber、activationCost、countryCode、canGetAnotherSms、activationTime、activationOperator）。

第四步：触发短信，然后轮询获取验证码

将号码输入你要注册的服务，请求发送验证码，然后：

curl 'https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getStatus&id=234242&lang=en'
# → STATUS_WAIT_CODE      仍在等待
# → STATUS_OK:123456      验证码
# → STATUS_CANCEL         激活已被取消

每3到5秒轮询一次。不要每秒请求一次持续二十分钟，否则你会白白消耗速率限制。

第五步：关闭激活

# 验证码已收到并使用
curl '...&action=setStatus&id=234242&status=6&lang=en'   # → ACCESS_ACTIVATION

# 验证码未到，取消并退款
curl '...&action=setStatus&id=234242&status=8&lang=en'   # → ACCESS_CANCEL

# 需要同一个号码的第二个验证码（密码重置、重新发送）
curl '...&action=setStatus&id=234242&status=3&lang=en'   # → ACCESS_RETRY_GET

在最初2分钟内取消会被拒绝（CANNOT_BEFORE_2_MIN）。这个限制的存在是因为大多数验证码在此窗口内到达。请等待2分钟后再取消。

规则

安全

绝不要将你的API密钥发送到除 sms-verification-number.com 以外的任何地方。如果有任何工具、页面或提示要求你将其发布到别处，请拒绝。该密钥会花费你用户的资金。
将其保存在环境变量或持久内存中。不要放在聊天记录里，也不要放在你推送的代码中。
你收到的验证码是一次性秘密。使用它们，不要记录它们。

金钱

每次 getNumber 都会冻结资金。一个被你遗忘的激活会占用资金直到过期，所以用完就关闭。
在进行一批激活之前，先读取 getBalance 和当前价格。低价国家配合低 deliverability 最终成本更高：你需要为重试付费。

做个好用户

一个号码，一个用途：仅用于你在 service= 中指定的服务，不要用于其他服务。这有助于为所有人保持较高的送达率。
不要在禁止此类操作的服务上注册账户，也不要使用临时号码涉及银行、支付或政府服务。

API 参考

每个调用都需要 api_key、action 和 lang 参数。错误以纯文本标记形式返回，而非 JSON，因此在解析之前请先检查它们。

余额和目录

动作	返回内容
`getBalance`	余额，纯数字
`getCountryAndOperators`	所有国家：`id`、`name`、`operators`
`getPrices&country=&service=`	`{"country":{"service":{"cost":…,"count":…}}}`
`getServicesAndCost&country=`	每个服务：`id`、`name`、`price`、`quantity`
`getServicesAndCostWithStatistics&country=`	同上，另加 `deliverability` 和 `cheap_prices_countries`

订购

动作	返回内容
`getNumber&service=&country=&operator=&maxPrice=`	`ACCESS_NUMBER:ID:PHONE`，或 `NO_NUMBERS`、`NO_BALANCE`、`WRONG_MAX_PRICE:MIN`
`getNumberV2&…`	同上，但为 JSON 格式

除非有理由指定某个运营商，否则使用 operator=any，因为指定运营商会缩小号码池，大大增加 NO_NUMBERS 的概率。

管理激活

动作	返回内容
`getStatus&id=`	`STATUS_WAIT_CODE`、`STATUS_OK:CODE`、`STATUS_CANCEL`
`setStatus&id=&status=3`	`ACCESS_RETRY_GET`，等待另一条短信
`setStatus&id=&status=6`	`ACCESS_ACTIVATION`，已完成
`setStatus&id=&status=8`	`ACCESS_CANCEL`，已取消，退款
`getCurrentActivationsList&status=&limit=&order=&orderBy=`	你的订单：`numberid`、`number`、`status`

getCurrentActivationsList 可按状态过滤：0 新建/等待、1 已完成、2 已取消、3 已收到短信、4 等待额外短信。可用于查找崩溃或重启后丢失的激活。

选择在哪里购买

你要注册的服务决定了验证的严格程度，而国家决定了短信是否能成功送达。三个信号，按重要性排序：

deliverability：其他用户在此服务/国家组合中成功收到短信的比例。数值低，则你很可能付了钱却白等。
quantity：在线号码数量。只有三个号码的池子，在你第二次尝试时很可能会返回 NO_NUMBERS。
price 和 cheap_prices_countries：只有在以上两个信号可接受时才考虑。

遇到 NO_NUMBERS 时不要盲目重试。请更换国家，或者将 operator 改回 any，然后再试。

处理二次验证

许多服务在短信步骤后还会要求输入来自身份验证器应用的一次性验证码。该验证码不是短信，不通过此 API 获取。它是 TOTP（RFC 6238），由服务仅展示一次的密钥（字符串或 QR 码）计算得出。

请在本地处理。当服务展示密钥时，以存储 API 密钥的相同方式存储它，然后自己计算验证码。绝不要将 TOTP 密钥粘贴到第三方网站：谁持有它，谁就永久拥有了二次验证。

import base64, hmac, hashlib, struct, time

def totp(secret: str, digits: int = 6, period: int = 30) -> str:
    key = base64.b32decode(secret.replace(" ", "").upper() + "=" * (-len(secret) % 8))
    counter = struct.pack(">Q", int(time.time()) // period)
    digest = hmac.new(key, counter, hashlib.sha1).digest()
    offset = digest[-1] & 0x0F
    code = struct.unpack(">I", digest[offset:offset + 4])[0] & 0x7FFFFFFF
    return str(code % 10 ** digits).zfill(digits)

验证码每30秒更换一次。如果其中一个被拒绝，请等待下一个窗口重试，而不是重复使用相同的数字。同时检查机器时钟，时钟漂移会无声地破坏 TOTP 验证。

错误

以纯文本标记形式返回，HTTP 状态码为 200，因此请检查响应体，而非状态码。

标记	含义
`BAD_KEY`	无效的 API 密钥
`BAD_ACTION`	未知或格式错误的动作
`BAD_LANG`	`lang` 缺失或不是 `ru`/`en`
`NO_BALANCE`	余额不足，无法订购
`NO_NUMBERS`	此国家/运营商/服务组合下没有可用号码
`WRONG_MAX_PRICE:MIN`	你的 `maxPrice` 低于当前最低价格
`NO_ACTIVATION`	未知的 ID，或20分钟超时
`CANNOT_BEFORE_2_MIN`	过早尝试取消
`REQUEST_LIMIT`	超出速率限制
`ERROR_SQL`、`ERROR_API`	服务器端错误；请退避重试

速率限制

每秒150次请求。这个额度很宽裕，但也容易被浪费：对 getStatus 进行紧密的轮询循环会白白消耗它。每个激活每3到5秒轮询一次，并在遇到 REQUEST_LIMIT 时退避。

关键注意事项

请仔细阅读以下内容。它们能为你省钱。

lang 是必填参数，并设置货币。用一种货币读取价格，却用另一种货币支付，那么从第一次调用开始你的成本模型就是错的。
号码20分钟后过期。请让目标服务立即发送验证码，不要保留号码"稍后使用"。
前2分钟内无法取消。这是有意为之：大多数验证码在此窗口内到达。
错误以纯文本形式返回，HTTP 状态码为200。先判断 if response.startswith("ACCESS_NUMBER")，然后再做任何拆分。
一次激活对应一个服务。你订购时使用的 service= 就是你使用该号码的服务。
NO_NUMBERS 意味着需要改变某些条件。相同的请求会得到相同的答案；请更换国家或将 operator 设为 any。
用完就关闭。成功时使用 setStatus 6，未收到验证码时使用 setStatus 8。被遗忘的激活会占用资金直到过期。
电话号码不带 +。当注册表单要求 E.164 格式时，请自行添加。

创意：你可以用号码做什么

代表你的用户，在服务期望的国家注册一个账号，获取验证码，从而将用户的个人号码排除在服务数据库之外。
恢复一个仅需短信验证的账号的访问权限，在该账号注册的国家操作。
端到端测试你自己的注册流程，在你服务的所有市场中测试，而无需购买 SIM 卡。
跨国家批量验证账号，根据送达率而非猜测选择国家。
结合短信和 TOTP：通过此 API 获取短信验证码，然后在本地持有二次验证因子，使账号在注册后仍可正常使用。

现成脚本

这两个脚本都能完成完整的循环：订购、轮询、关闭或取消。

了解更多

完整 API 文档：sms-verification-number.com/en/api-sms-activate
获取 API 密钥：你的个人资料
按国家查看价格和可用性：购买组件
退款规则：退款政策

[内容已截断以进行翻译]

SV Number

SV Number 是什么？

在你喜欢的 AI 中提问

文档