加载中…
SMSFast API 采用行业标准的 RESTful 架构设计，让开发者能够轻松集成和管理虚拟号码资源。
标准的HTTP方法（GET、POST、DELETE），统一的资源端点，直观的URL结构。
所有请求和响应均使用 JSON 格式，结构清晰，易于解析和处理。
通过 HTTP Header 中的 Bearer Token 进行身份验证，安全可靠。
每个 API Key 每分钟最多 60 次请求，确保服务的公平使用和稳定性。
以下是 SMSFast API 的主要端点，涵盖号码管理、短信接收和账户查询功能。
根据指定的国家代码和服务类型，申请一个新的虚拟号码用于接收短信。请求体中包含国家代码 (country) 和服务标识 (service)。
查询指定号码收到的所有短信记录，包含发送者、内容、时间戳等详细信息。
释放不再使用的虚拟号码资源，停止计费并归还号码池。
获取当前账户的余额信息，方便您管理和监控使用情况。
以下是使用 cURL 调用 SMSFast API 的典型示例，帮助您快速上手集成。
curl -X POST https://api.smsfast.com/v1/numbers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"country": "US",
"service": "telegram"
}'
# 响应示例
{
"id": "num_abc123",
"number": "+12025551234",
"country": "US",
"service": "telegram",
"created_at": "2024-01-15T08:30:00Z",
"expires_at": "2024-01-15T08:45:00Z"
}curl -X GET https://api.smsfast.com/v1/numbers/num_abc123/messages \
-H "Authorization: Bearer YOUR_API_KEY"
# 响应示例
{
"messages": [
{
"id": "msg_xyz789",
"sender": "Telegram",
"content": "您的验证码是 583921",
"received_at": "2024-01-15T08:31:05Z"
}
]
}SMSFast 提供多种主流编程语言的 SDK，降低集成门槛，加速您的开发流程。
pip install smsfast
npm install smsfast
composer require smsfast
Maven / Gradle
go get smsfast
关于短信API的常见疑问，请查看以下解答，或查阅完整文档获取更多信息。
Authorization: Bearer YOUR_API_KEY 即可完成认证。API Key 具有账户级别的权限，请妥善保管，不要在客户端代码中暴露。如怀疑 Key 泄露，你可以在控制面板中随时重新生成。429 Too Many Requests 状态码。如果你有更高的请求频率需求，可以在请求中使用合理的时间间隔控制，或者升级到企业版套餐获得更高的速率限制。详情可查阅价格方案或联系客服。400（请求参数错误）、401（认证失败）、404（资源不存在）、429（请求频率超限）和 500（服务器内部错误）。每个错误响应都包含 error 字段描述具体错误原因，以及 code 字段提供可程序化处理的状态码。建议在代码中对这些错误进行分类处理，并实现合理的重试逻辑。