上一篇
httpclient接口短信
通过HttpClient向短信API发送POST请求，传递密钥、号码及内容
HTTPClient接口短信调用基础
接口定义与功能
短信HTTP接口通常由第三方短信服务商提供,支持通过HTTP协议发送短信请求，主要功能包含：
- 验证码短信（如登录/注册场景）
- 营销类短信
- 通知类短信（如物流提醒、系统告警）
典型请求方式：POST 请求携带JSON/XML格式数据
核心配置要素
| 配置项 | 说明 | 示例值 |
|---|---|---|
| 接口URL | 短信服务商提供的API端点 | https://api.xxx.com/sms |
| 请求方法 | HTTP动词 | POST |
| 超时时间 | 网络请求最大等待时长 | 5000ms |
| 编码格式 | 请求体字符编码 | UTF-8 |
| 签名机制 | 身份验证方式（如MD5签名） | appKey+timestamp+md5 |
HTTPClient调用关键步骤
依赖引入（以Apache HttpClient为例）
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.13</version>
</dependency>请求参数构造
| 参数名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| phoneNumber | String | 是 | 目标手机号（需带区号） |
| templateCode | String | 是 | 短信模板ID |
| signature | String | 是 | 安全签名（MD5/HMAC） |
| timestamp | Long | 是 | 请求时间戳（毫秒级） |
| params | Map | 否 | 模板变量填充值 |
签名生成示例（MD5）
String signSource = appKey + timestamp + secretKey; String signature = DigestUtils.md5DigestAsHex(signSource.getBytes());
异常处理与状态码对照
常见HTTP状态码
| 状态码 | 含义 | 处理方案 |
|---|---|---|
| 200 | 请求成功 | 正常流程处理 |
| 401 | 鉴权失败 | 检查appKey/secretKey |
| 404 | 接口不存在 | 核对接口地址 |
| 500 | 服务器内部错误 | 重试机制（指数退避策略） |
业务错误码（示例）
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 10001 | 余额不足 | 充值或切换测试账号 |
| 10005 | 黑名单号码 | 联系客服解除屏蔽 |
| 20002 | 参数校验失败 | 检查必填字段和格式 |
性能优化建议
- 连接池复用：使用
PoolingHttpClientConnectionManager管理连接 - 异步调用：结合CompletableFuture实现非阻塞发送
- 批量处理：合并多条短信请求（需接口支持）
- 压缩传输：启用GZIP压缩减少带宽消耗
【问题与解答】
Q1：如何测试短信接口的可用性？
A：可通过以下方式验证：
- 使用Postman发送标准测试请求
- 调用服务商提供的测试号码（如
123456） - 检查返回的
messageId是否非空 - 核对服务商控制台的发送记录
Q2：遇到”503 Service Unavailable”如何处理？
A：该状态码表示服务端过载，建议：
- 开启指数退避重试机制（如第1次间隔1s，第2次2s）
- 联系服务商获取当前服务状态
- 检查是否触发频率限制（如单账号QPS超限）
- 切换备用
