API

REST API 用于订购虚拟号码、轮询 SMS、管理租赁和钱包充值。仪表板使用的相同端点 — Bearer Token 认证、JSON 输入/输出、无需 SDK。

认证

仪表板 → API Token生成个人 API Token。在每个请求的 Bearer Header 中包含它:

Authorization: Bearer <your-token>

基础 URL

https://smsactivator.io

端点

  • GET/v1/services列出支持的服务及当前按国家计价。
  • GET/v1/countries列出库存活跃的国家。
  • POST/v1/orders订购虚拟号码。请求体:{ serviceSlug, countryIso }。返回分配的号码和 orderId。
  • GET/v1/orders/:id轮询 SMS 接收状态。返回 { status, sms, expiresAt }。
  • DELETE/v1/orders/:id取消活跃订单。如未收到 SMS 则退款至钱包。
  • POST/v1/payments创建加密货币充值发票。请求体:{ provider, amountUsd, cryptoCurrency? }。返回 OxaPay 支付链接。
  • GET/v1/wallet获取当前钱包余额和最近交易。
  • GET/v1/rentals列出活跃的长期租赁。

快速开始

curl -X POST https://smsactivator.io/v1/orders \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"serviceSlug":"telegram","countryIso":"US"}'

速率限制

  • 订单下单:30 次请求 / 分钟 / Token
  • 订单轮询:120 次请求 / 分钟 / Token
  • 支付 / 充值:10 次请求 / 小时 / Token
  • 全局每 IP 限制:120 次请求 / 分钟(无 Token 也适用)

达到限制返回 HTTP 429,带有 Retry-After Header。

需要更高的限制?

联系 @smsactivator_support说明你的使用场景。经销商和集成计划可获得订单端点的 10 倍突发预算。