短信APIKEY
短信APIKEY是企业通信服务/电信增值业务中,用于调用短信接口的重要身份验证密钥。通过它,企业可实现短信验证码下发、语音通知发送等功能。
基本定义
短信APIKEY是一串特定字符串,是企业调用短信服务API的凭证。它与APIID配合使用,为企业和短信服务提供商之间建立安全、可靠连接,确保短信数据准确传输和调用权限验证。
核心技术参数
| 参数名称 | 参数值描述 | 示例 | 类型 | 必填 |
| account | APIID(用户中心【文本短信】-【验证码/通知短信】-【产品总览】查看) | xxxxxxxx | string | 是 |
| password | 1、APIKEY(用户中心【文本短信】-【验证码/通知短信】-【产品总览】查看);2、动态密码(生成动态密码方式请看该文档末尾的说明) | xxxxxxxxx | string | 是 |
| mobile | 根据发送方式不同:1、完整内容方式:提交完整的短信内容;2、模板变量方式:模板中的变量内容,多个变量以英文竖线(|)隔开。支持500字以内的长短信,长短信按多条计费 | 136xxxxxxxx | string | 是 |
| content | 短信内容,注:模板ID为空时必填 | 您的验证码是:1234。请不要把验证码泄露给其他人。 | string | 否 |
| templateid | 短信模板ID(使用模板变量方式发送时必填),调试阶段可使用系统默认模板ID:1(模板内容为:您的验证码是:【变量】。请不要把验证码泄露给其他人。) | 1 | string | 否 |
| time | Unix时间戳(10位整型数字,当使用动态密码方式时为必填) | 1623643787 | string | 否 |
核心功能
短信验证码下发
企业在用户注册、登录、支付等环节,通过短信APIKEY调用短信接口,向用户手机发送验证码,用于身份验证。
短信通知发送
可发送各类通知短信,如订单通知、会议提醒、活动通知等。
语音通知接口调用
企业可借助短信APIKEY调用语音通知接口,以语音形式向用户传达重要信息。
接入流程
准备工作
注册互亿无线账号并完成实名认证,开通短信服务后,获取接口调用所需的APIID和APIKEY信息。
企业认证
根据工信部及运营商要求,国内短信需提供签名归属方的资质证件。完成企业实名认证,再进行签名和模板的申请。
申请短信签名和模板
申请能明确辨别主体的短信签名,签名审核通过后申请模板。
接口对接与测试
将短信APIKEY集成到企业系统中,进行接口对接。完成后进行联调测试,确保短信发送正常。
上线使用
测试无误后,正式上线使用短信服务。
适用场景
在电商、金融、社交、出行等行业广泛应用。电商用于订单通知、物流提醒;金融用于账户安全验证、交易提醒;社交用于注册登录验证;出行用于行程提醒、票务通知。
避坑指南
妥善保管短信APIKEY,防止泄露;确保短信内容合规,避免违规发送;关注账户余额,及时充值,防止因余额不足导致接口调用失败。
FAQ
问:验证码通知短信套餐包能用于发送营销短信吗?
答:不可以。验证码通知短信套餐包仅能用于发送验证码短信和通知短信,如需发送营销短信,请购买营销短信套餐包。
问:为什么接口发送时提示余额不足?
答:套餐包在账户欠费时不可使用,请核实账户余额是否大于0。套餐包短信条数有剩余且账户没有欠费时才可以正常调用短信接口。
互亿无线为企业提供专业短信APIKEY服务,在安全验证、通知发送等功能上表现出色,严格遵循行业标准,为各行业提供稳定、可靠的企业通信服务。
