短信API接入指南：从零开始对接国际短信接口

短信 API 是企业把短信发送能力接入自有系统的标准方式：注册、登录验证码、订单通知、营销群发，都可以通过接口自动完成。这篇指南讲清楚短信 API 的基本概念、调用流程和常见问题，并整理了主流编程语言的接入教程。

什么是短信 API

短信 API（Application Programming Interface）是短信服务商提供的程序化调用接口。企业通过 HTTP/HTTPS 请求或 SMPP 协议，把手机号码和短信内容发送给服务商，服务商通过运营商通道送达用户手机，再通过回调或查询接口返回发送状态。

相比手动登录平台群发，API 接入的核心价值是自动化：触发即发（用户注册、支付成功自动触发验证码）、批量发送、实时状态回执、与自有系统（CRM、订单系统）深度集成。

短信 API 调用流程

1. 注册账号：在短信服务商平台注册，获取产品编号（sp_id）。
2. 获取密钥：在开发者文档中获取接口密码（password），通常由 sp_id 密码加密生成。
3. 报备签名与模板：提交短信签名（如【智慧云信】）和短信模板，审核通过后才能发送。
4. 调用接口：按文档构造请求，发送号码、内容、签名等参数。
5. 处理回执：通过响应或回调获取发送状态（成功/失败/送达），更新业务数据。

常用参数说明

• sp_id：产品编号，6 位数字，唯一标识你的产品。
• mobile：接收短信的手机号码，国际号码需带国家代码。
• content：短信内容，包含签名和正文。
• password：接口密码，由 sp_id 密码 MD5 加密生成，非登录密码。

主流语言接入教程

以下整理了 14 种编程语言的短信 API 接入教程，包含完整的请求示例和 JSON 解析代码，可直接参考：

• PHP 调用短信接口教程
• Java 调用短信接口教程
• ASP 调用短信接口教程
• ASP.NET (C#) 调用短信接口教程
• JSP 调用短信接口教程
• Node.js 调用短信接口教程
• Delphi 调用短信接口教程
• Go 调用短信接口教程
• Python 调用短信接口教程
• Ruby 调用短信接口教程
• Shell 调用短信接口教程
• VB 调用短信接口教程
• C++ 调用短信接口教程
• C 语言调用短信接口教程

常见问题

短信内容需要 URL 编码吗

需要。content 参数可能包含空格、引号等特殊字符，传输前要做 URL 编码，确保特殊字符正确传递。

如何判断发送成功

通过接口响应中的 code 字段判断请求是否受理，通过异步回执（送达状态）判断是否真正送达。

签名和模板没审核能发吗

不能。国内短信和国际短信都要求先完成签名报备和模板审核，验证码类短信可使用系统免审核模板。

支持 SMPP 协议吗

支持。对发送量大、需要深度集成的企业，平台提供 SMPP 通道接入。

开始接入

技术团队可以在智慧云信验证码短信平台注册后，从开发者文档获取完整的接口说明和参数示例。如果只是小批量发送，也可以直接使用在线群发功能，无需开发。