账户

您可以在这里获得API端口、API密钥以及查询账户余额接口.

端口描述

API是您的软件和我们的激活服务器之间的互动协议。为了使您的短信接收过程自动化需要API。要使用API，您必须使用您的API密钥，所有请求均进入 https://nzsms.com/api/。全部接口仅接受 X-API-Key: YOUR_APIKEY 或 Authorization: Bearer YOUR_APIKEY 请求头。不要在 URL 或 JSON 请求体中传递密钥。网页控制台继续使用安全会话 Cookie。

X-API-Key: YOUR_APIKEY
# 或 Authorization: Bearer YOUR_APIKEY

APIKEY

您的APIKEY： 登录后在用户控制台查看

查询余额

https://nzsms.com/api/me
参数类型必需的描述
X-API-Keyheader / string是的您的APIKEY
正确的结果:
{"ok":true,"balance":"96.72"}
可能的错误:
{"detail":"无效的 API 密钥。"}

请求号码

POST https://nzsms.com/api/orders/create
{"service_id":510042,"service_name":"WeChat","country_name":"泰国","provider":"acsim","cost":"0.13"}

获取短信

POST https://nzsms.com/api/orders/1001/sms
{}

更改请求状态

POST https://nzsms.com/api/orders/1001/release
{}

未收到短信时释放号码；如释放前已经回码，系统会同步短信并按成功订单处理。

重新激活号码

POST https://nzsms.com/api/orders/1001/sms
{}

等待状态可重复点击 C 获取短信；成功返回短信时才扣用户分。

获取国家列表

GET https://nzsms.com/api/countries

国家列表由本地缓存返回，每天自动同步一次，接口异常时使用旧缓存兜底。

获取服务列表

GET https://nzsms.com/api/services?country=泰国&service=WeChat

服务搜索会短期缓存服务列表，再按国家本地过滤，用于降低切换国家时的等待时间。

获取短信记录

GET https://nzsms.com/api/orders

获取可租借地区

GET https://nzsms.com/api/rent/tariffs
GET https://nzsms.com/api/rent/tariffs?area_code=US

不传 area_code 返回地区列表；传入 area_code 返回该地区可租月份和平台售价。

租借号码

POST https://nzsms.com/api/rent/create
{"area_code":"US","time":1}

租借成功后立即扣费。租借开始 20 分钟内未收到短信，号码处于可关闭状态时可退款。

获取租借订单

GET https://nzsms.com/api/rent/orders?tab=active
GET https://nzsms.com/api/rent/orders?tab=expired

获取租借短信

POST https://nzsms.com/api/rent/1001/sms
{}

关闭租借号码

POST https://nzsms.com/api/rent/1001/close
{}

号码处于可关闭状态时会关闭成功；成功后平台自动退回该租借订单扣除的余额。

续租号码

GET https://nzsms.com/api/rent/1001/renew-options
POST https://nzsms.com/api/rent/1001/renew
{"time":1}

通用短信接收 - 请求号码

POST https://nzsms.com/api/keyword-orders/create
{"country":"中国","keyword":"验证码","mobile":"","dedupe":"0"}

通用短信接收 - 获取短信

POST https://nzsms.com/api/orders/1001/sms
{}

通用短信接收 - 释放号码

POST https://nzsms.com/api/orders/1001/release
{}

通用短信接收 - 获取短信记录

GET https://nzsms.com/api/orders