Skip to main content
注册
首页/文档中心/开发者中心/国际短信 API

国际短信 API

国际短信 API 用于提交海外手机号短信单发或群发请求。国际号码必须包含国际地区前缀，并注意 + 号需要进行 URL Encode 处理。

查看旧 OpenAPI 原文

接口概览

项目说明
接口用途提交国际短信单发或群发请求。
请求方式GET。
编码要求统一使用 UTF-8，短信内容需要 URL Encode。
号码格式国际号码需包含地区前缀，并以 + 号开头；+ 号需要 URL Encode。
群发限制多个号码用英文逗号分隔，一次不超过 99 个号码。

请求地址

GET https://api.smsbao.com/wsms
?u=USERNAME
&p=PASSWORD_OR_APIKEY
&m=PHONE
&c=CONTENT
接口地址
普通接口http://api.smsbao.com/wsms?u=USERNAME&p=PASSWORD&m=PHONE&c=CONTENT
安全接口https://api.smsbao.com/wsms?u=USERNAME&p=PASSWORD&m=PHONE&c=CONTENT

请求参数

参数必填示例说明
u是tom短信宝平台注册用户名。
p是32 位 MD5 或 ApiKey平台登录密码 MD5 后的 32 位值，或后台 / 客服提供的 ApiKey。
m是+60901234567接收手机号；国际号码必须包含国际地区前缀，+ 号需要 URL Encode。
c是URL Encode 后的短信内容短信内容，采用 UTF-8 URL Encode。

返回结果

返回含义处理方式
0提交成功。继续结合发送记录、状态和用户反馈确认最终结果。
其他内容错误提示或错误码。对照错误码、号码格式、余额、内容和国际地区规则排查。

常见错误码

错误码含义处理建议
30错误密码。检查密码 MD5 值或 ApiKey 是否正确，避免测试账号和正式账号混用。
40账号不存在。确认用户名是否正确，账号是否可正常登录。
41余额不足。检查账户余额、套餐状态或产品余额。
43IP 地址限制。检查接口调用服务器 IP 是否在允许范围内。
50内容含有敏感词。检查短信内容、签名、模板变量和营销合规要求。
51手机号码不正确。检查号码格式、国家区号、分隔符和空格。

注意事项

  • 国际号码应包含国家或地区前缀，例如 +60901234567。
  • + 号需要 URL Encode，否则可能出现号码格式错误。
  • 不同国家或地区的发送限制、价格和到达结果可能不同，建议先小量测试。
  • 国际短信内容同样需要关注签名、模板、语言和当地规则。