一、引言：短信接口的集成价值

在数字化服务场景中，短信接口作为企业与用户实时沟通的核心通道，承担着验证码下发、通知推送、营销推广等关键任务。联通短信接口凭借其高覆盖率（覆盖全国99%以上用户）和稳定性（平均响应时间<1秒），成为开发者集成短信服务的优选方案。本文将围绕Java后端与JavaScript前端的双维度，系统阐述联通短信接口的调用方法，助力开发者快速实现功能落地。

二、Java调用联通短信接口：后端服务集成

1. 环境准备与依赖配置

Java项目需引入HTTP客户端库（如Apache HttpClient或OkHttp）及JSON解析库（如Jackson或Gson）。以Maven项目为例，需在pom.xml中添加依赖：

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.13</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.0</version>
</dependency>

2. 接口调用核心流程

步骤1：构建请求参数

联通短信接口通常要求以下参数：

• account：开发者账号
• password：加密后的密码（MD5或SHA256）
• mobile：目标手机号（支持单条或多条，多条用逗号分隔）
• content：短信内容（需包含签名，如【XX企业】）
• time：可选时间戳（防止重放攻击）

步骤2：发送HTTP请求

使用HttpClient发送POST请求示例：

public class ChinaUnicomSMSClient {
    private static final String URL = "https://api.10010.com/sms/send";
    public String sendSMS(String account, String password, String mobile, String content) throws Exception {
        CloseableHttpClient httpClient = HttpClients.createDefault();
        HttpPost httpPost = new HttpPost(URL);
        // 构建JSON请求体
        JSONObject params = new JSONObject();
        params.put("account", account);
        params.put("password", DigestUtils.md5Hex(password)); // 使用Apache Commons Codec
        params.put("mobile", mobile);
        params.put("content", content);
        httpPost.setEntity(new StringEntity(params.toString(), ContentType.APPLICATION_JSON));
        // 执行请求并解析响应
        CloseableHttpResponse response = httpClient.execute(httpPost);
        String result = EntityUtils.toString(response.getEntity());
        return result;
    }
}

步骤3：处理响应结果

联通接口通常返回JSON格式数据，示例响应：

{
    "code": "0000",
    "message": "成功",
    "data": {
        "taskId": "123456789",
        "successCount": 1
    }
}

需解析code字段判断是否成功（0000表示成功），失败时根据message排查问题。

3. 安全优化建议

• 参数加密：对敏感字段（如密码）进行加密传输。
• IP白名单：在联通后台配置服务器IP，限制非法调用。
• 频率限制：单账号每秒调用不超过5次，避免触发风控。

三、JS调用联通短信接口：前端轻量级集成

1. 适用场景与限制

JavaScript调用短信接口适用于：

• 前端直接触发验证码下发（需配合后端验证）
• 纯静态页面中的短信通知功能

限制：浏览器端无法直接调用联通官方API（需跨域），通常需通过以下两种方式实现：

1. 后端代理：前端调用自身后端接口，由后端转发至联通。
2. 第三方SDK：使用联通提供的JS SDK（需申请权限）。

2. 基于后端代理的实现方案

步骤1：前端发起请求

async function sendSMS(mobile) {
    const response = await fetch('/api/send-sms', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({ mobile }),
    });
    const result = await response.json();
    if (result.code === '0000') {
        alert('短信已发送');
    } else {
        alert(`发送失败：${result.message}`);
    }
}

步骤2：后端代理转发

后端（如Node.js）需实现代理逻辑：

const express = require('express');
const axios = require('axios');
const app = express();
app.use(express.json());
app.post('/api/send-sms', async (req, res) => {
    try {
        const { mobile } = req.body;
        const response = await axios.post('https://api.10010.com/sms/send', {
            account: 'YOUR_ACCOUNT',
            password: 'MD5_PASSWORD',
            mobile,
            content: '【测试】您的验证码是1234',
        });
        res.json(response.data);
    } catch (error) {
        res.status(500).json({ code: '9999', message: '系统错误' });
    }
});
app.listen(3000);

3. 第三方SDK集成（如适用）

若联通提供JS SDK，需按官方文档引入：

<script src="https://api.10010.com/sdk/unicom-sms.js"></script>
<script>
    UnicomSMS.init({
        account: 'YOUR_ACCOUNT',
        appKey: 'YOUR_APPKEY'
    });
    function sendSMS() {
        UnicomSMS.send({
            mobile: '13800138000',
            content: '测试短信',
            success: function(data) {
                console.log('发送成功', data);
            },
            error: function(err) {
                console.error('发送失败', err);
            }
        });
    }
</script>

四、常见问题与解决方案

1. 签名错误

• 原因：短信内容未包含签名或签名格式错误。
• 解决：确保内容以【签名】开头，签名需在联通后台备案。

2. 频率限制

• 现象：返回code: 1002（调用过于频繁）。
• 解决：实现队列机制，控制每秒调用次数。

3. 跨域问题

• 现象：前端直接调用接口报CORS错误。
• 解决：使用后端代理或配置Nginx反向代理。

五、总结与建议

1. 优先后端集成：Java等后端语言更适合处理核心短信逻辑，保障安全性。
2. 前端轻量使用：JS调用仅推荐用于辅助功能，核心逻辑仍需后端控制。
3. 监控与日志：记录所有短信请求与响应，便于排查问题。
4. 合规性检查：确保短信内容符合《通信短信息服务管理规定》，避免违规风险。

通过本文的详细指南，开发者可快速掌握Java与JavaScript调用联通短信接口的方法，并根据实际业务场景选择最优实现路径。