使用PHP调用短信接口发送验证码短信教程
PHP对接验证码短信接口DEMO示例
<p><img title="使用PHP调用短信接口发送单条短信教程(图1)" alt="使用PHP调用短信接口发送单条短信教程(图1)" src="/uploads/allimg/20240522/1-240522203949305.jpeg"/></p>
<p>短信验证码是各类网站和应用里最常见的验证手段,用户注册、登录、找回密码时基本都会用到。这篇文章介绍如何用 PHP 调用短信接口,实现单条短信的发送。</p>
<h2>接口地址与调用方式</h2>
<p>本次使用的接口地址为 <code>https://api.3yit.com/api/send-sms-single</code>,支持 POST 请求,返回格式为 JSON。调用时需传入 <code>sp_id</code>、<code>mobile</code>、<code>content</code> 等参数,身份验证在 <code>signature</code>(签名)和 <code>password</code>(密码)之间二选一。</p>
<h2>获取接口参数</h2>
<p>登录智慧云信官网,选择对应的产品(如【验证码】),在上方选项卡中点击【开发者】→【HTTP开发文档】,就能看到具体的 API 方法名称,以及各参数的 key 和对应值,通常包括 <code>sp_id</code>、<code>mobile</code>、<code>content</code>、<code>password</code> 等。各参数含义如下:</p>
<ul><li><code>sp_id</code>:产品编号,全局唯一,一般由 6 位数字组成。</li><li><code>mobile</code>:接收短信的手机号码。</li><li><code>content</code>:短信内容,包含签名和正文。例如“【智慧云信】您的验证码是456790,请妥善保管”,其中【智慧云信】是签名,需在签名报备中申请;后面的提示语是短信模板,需在模板报备中申请,审核通过后才能发送。</li><li><code>password</code>:用 SP_ID 密码经 MD5 加密后生成的接口密码(非登录密码),由 32 位随机字符串组成。</li></ul>
<h2>PHP 代码实现</h2>
<p>下面是用 PHP 调用该接口发送单条短信的示例代码:</p>
<pre><code>&lt;?php
// 设置接口地址和参数
$url = 'https://api.3yit.com/api/send-sms-single';
$params = array(
'sp_id' =&gt; '5xxxxx', // 替换为实际的产品sp_id
'mobile' =&gt; '176xxxxxxxx', // 替换为实际的手机号,支持md5和aes加密
'content' =&gt; '【签名】验证码123', // 替换为实际的短信内容,支持aes加密
// 'signature' =&gt; 'a92569901189fxxxxxxxx957c096c432e2d47635', // 如果使用签名验证,则取消注释并替换为实际的签名
// 'password' =&gt; md5('your_password_here'), // 如果使用密码验证,则取消注释并替换为实际密码的md5值
'ext' =&gt; '123', // 可选参数,根据需求填写
);
// 发送POST请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/x-www-form-urlencoded'));
$output = curl_exec($ch);
curl_close($ch);
// 处理返回结果
$result = json_decode($output, true);
if ($result['code'] == 0) {
echo '短信发送成功,消息ID:' . $result['msg_id'];
} else {
echo '短信发送失败,错误信息:' . $result['msg'];
// 如果需要,可以根据$result['data']获取更详细的错误信息
}
?&gt;</code></pre>
<h2>注意事项</h2>
<ul><li>实际使用时,把 <code>sp_id</code>、<code>mobile</code>、<code>content</code> 等参数替换成自己的值。</li><li>选择签名验证时,签名算法要与接口文档一致,把签名值填到 <code>$params</code> 数组的 <code>signature</code> 键上;选择密码验证时,把密码做 MD5 加密后填到 <code>password</code> 键上。</li><li>手机号和短信内容支持 md5 和 aes 加密,具体按接口文档要求处理。</li><li>处理返回结果时,根据 <code>code</code> 判断短信是否发送成功,需要时读取 <code>msg</code> 和 <code>data</code> 字段。</li></ul>
<h2>总结</h2>
<p>用 PHP 调这个接口发短信,步骤不复杂:按文档把请求地址、参数、请求头设置好,发一条 POST 请求,再处理返回结果就行。实际项目里按自己的业务场景调整即可。</p>
<p><strong>其他语言教程:</strong><a href="https://www.3yit.com/smsapi/282.html" title="Java短信接口教程">Java</a> · <a href="https://www.3yit.com/smsapi/283.html" title="ASP短信接口教程">ASP</a> · <a href="https://www.3yit.com/smsapi/284.html" title="ASP.NET(C#)短信接口教程">ASP.NET(C#)</a> · <a href="https://www.3yit.com/smsapi/285.html" title="JSP短信接口教程">JSP</a> · <a href="https://www.3yit.com/smsapi/286.html" title="Node.js短信接口教程">Node.js</a> · <a href="https://www.3yit.com/smsapi/298.html" title="Delphi短信接口教程">Delphi</a> · <a href="https://www.3yit.com/smsapi/300.html" title="Go短信接口教程">Go</a> · <a href="https://www.3yit.com/smsapi/301.html" title="Python短信接口教程">Python</a> · <a href="https://www.3yit.com/smsapi/302.html" title="Ruby短信接口教程">Ruby</a> · <a href="https://www.3yit.com/smsapi/303.html" title="Shell短信接口教程">Shell</a> · <a href="https://www.3yit.com/smsapi/304.html" title="VB短信接口教程">VB</a> · <a href="https://www.3yit.com/smsapi/305.html" title="C++短信接口教程">C++</a> · <a href="https://www.3yit.com/smsapi/306.html" title="C短信接口教程">C</a>。更多信息见<a href="https://www.3yit.com/smsapi/613.html" title="短信API接入指南">短信API接入指南</a>。</p>
<p>代码里的 API 地址、账号和密码替换成你自己的就能跑通。如果还没有账号,去智慧云信官网注册一个,注册就能免费测试,验证码、通知、营销短信都支持。</p>
内容可信度说明
作者:智慧云信通信技术团队
技术审核:国际短信与号码检测产品组
最后更新:2026-08-13
本文主题:使用PHP调用短信接口发送验证码短信教程
本文围绕「使用PHP调用短信接口发送验证码短信教程」展开,结合智慧云信平台在短信接口API场景下的产品能力与客户接入经验整理。不同国家/地区的 Sender ID、模板审核、计费方式和合规要求可能变化,实际发送前建议以当前通道审核与项目沟通结果为准。