Appearance
短信服务概览
欢迎使用 StarCloud 第三方短信平台。本短信源基于阿里云短信能力，因此部分模板、签名和发送规则遵循阿里云短信要求。请妥善保管平台账户、密码和 API 密钥；如账户或密钥疑似泄露，请及时重置。
Endpoint
Base URL https://smspanel.szczk.top
本文档基于项目 smspanel.szczk.top 接口实现，所有接口均从上述 Endpoint 发起请求。
接入方式
SysKey 方式
通过 GET 请求和 syskey 识别请求者，适合快速集成、轻量发送和内部系统接入。
AK/SK 方式
兼容阿里云短信 API 签名协议，支持 GET/POST，适合已有阿里云兼容工具或需要强签名校验的环境。
短信宝协议
兼容短信宝网关格式，用户名 + SysKey 鉴权，适合对接已支持短信宝通道的第三方系统。
腾讯云协议
兼容腾讯云短信 SendSms 接口（TC3-HMAC-SHA256 签名），可直接使用腾讯云官方 SDK。
能力说明
- SysKey 支持验证码模式和模板模式。
- 短信宝协议使用用户名 + SysKey 鉴权，自动按正文匹配已审核模板。
- 腾讯云协议兼容 TC3-HMAC-SHA256 签名，可直接使用腾讯云官方 SDK 接入。
- AK/SK 方式兼容阿里云官方
SendSms协议，支持 GET 和 POST 两种请求方式。 - 106 签名按账户类型自动处理：会员可使用管理员配置的不同签名前缀，免费用户强制使用系统默认签名。
- 所有接入方式均支持配额校验、速率校验和发送日志记录，速率限制可在短信后台配置。
- 支持 IP 白名单、号码真实性检测、虚拟号段拦截等安全策略，可在后台按账户开启。
安全策略
| 功能 | 说明 |
|---|---|
| IP 白名单 | 配置后仅白名单内的 IP 可调用接口，其他 IP 返回 403 IpNotAllowed。多个 IP 用英文逗号分隔。 |
| 号码真实性检测 | 开启后对目标号码做有效性校验，不通过的号码返回 400 InvalidPhoneNumber。 |
| 虚拟号段拦截 | 开启后拦截虚拟运营商号段，返回 400 VirtualNumberBlocked。 |
| 第三方运营商拦截 | 开启后仅放行电信/联通/移动/广电号码，其他运营商返回 400 CarrierBlocked；查询接口异常时默认放行。 |
以上策略均在短信后台的账户设置中开启，未开启时不做对应检查。