短信接口

一个简单的 REST API 发送短信

使用令牌标头发布您的发件人、收件人和内容。直接获取消息 ID,并将发送报告推送到您的服务器。

发送您的第一条短信

一个请求,一条消息

使用您的访问密钥进行身份验证,发布消息,然后从响应中读取 msgid。按下按钮即可看到它运行。

curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \
  -H "Token: $SMSLOCAL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "SMSLOCAL",
    "to": "14155550123",
    "content": "Your code is 481920."
  }'
POST /外部/短信
邮政/external/sms
回复

运行请求以查看响应。

为开发者打造

没什么新奇的东西可学

三个思想涵盖了整个API,遵循简单 休息 惯例。

  1. 验证

    令牌认证

    在每个请求的 Token 标头中发送您的访问密钥,并使用 JSON 输入和 JSON 输出。

    • 无需SDK
    • 适用于任何语言
    • 将密钥保存在环境变量中
  2. 回复

    知道已被接受

    每次发送都会立即返回一个 msgid 和一个错误代码。

    • 根据您自己的记录存储 msgid
    • 错误代码 0 表示已接受
    • 稍后使用 msgid 来匹配报告
  3. 回复

    默认双向

    回复通过同一回调到达,标记为移动发起。

    • 与报告相同的消息形状
    • 用 mt / mo 区分方向
    • 将回复路由至您的支持工具
交付报告

查看每条消息发生了什么

状态报告已发布到您的 回调地址 当消息达到最终状态时。

  1. 1
    按 msgid 匹配每份报告都带有您在发送时获得的 ID。
  2. 2
    仅最终状态当消息已送达或失败时,您会听到消息。
  3. 3
    1个回调URL同一端点接收报告和回复。
发货日志说明性的
  • 9f2a7c10+1 415 ••• 0123发表现在
  • 9f2a7c11+91 98••• 43210发表3 秒前
  • 9f2a7c12+44 7••• 123456待办的5 秒前
  • 9f2a7c13+91 99••• 00012失败的9 秒前
发送前了解

查看消息的计数方式

较长的文本和非拉丁字符会改变消息的计费部分。尝试你自己的措辞,然后 查一个号码 在您发送之前。

GSM746 人物160 每个部分
1部分单独计费
  • 部分 1
    46 / 160

一部分可容纳 GSM7 中的 160 个字符或 Unicode 中的 70 个字符。一个非 GSM 字符(例如表情符号或印地语字母)会将整个消息切换为 Unicode。

为什么需要 API

停止手动将消息粘合在一起

拖动分隔线进行比较。

使用短信APIYour appSMS APIone endpointCustomersdelivery reports and replies, pushed back
  • 从您自己的代码发送的消息
  • 每条消息都有一份报告
  • 回复推送到您的系统
没有消息 APIYour teamCSV exportSpreadsheetVendor portalShared inboxCustomers???
  • 手动导出和上传
  • 不知道消息是否到达
  • 回复落在某人的收件箱中
在您上线之前

简短的启动前检查清单

0%0 的 9

边走边勾选项目。这里什么都没有保存。

01帐户
02合规性(印度)
03测试
继续建设

为您的集成提供更多帮助

无论您身在何处,都可以拿起。其中每一个都建立在相同的帐户和访问密钥之上。

  1. 开发者文档完整的 API 参考和示例。
  2. 网络钩子您如何收到递送报告和回复。
  3. 验证API在同一帐户上构建的一次性密码。
  4. CPaaS平台其他一切你都可以打开。
回答您的问题

SMS API — 常见问题

在每个请求的 Token 标头中传递您的访问密钥以及 Content-Type: application/json。

每次发送都会返回一个 msgid。将我们指向回调 URL,当消息达到最终状态时,我们会向其发布状态报告。

GSM7 编码为 160 个字符,Unicode 为 70 个字符。较长的消息由多个部分连接而成,每个部分单独计费。

是的。入站回复将传递到相同的回调 URL 并标记为移动发起。

是的。发送至印度号码的 SMS 必须使用经批准的实体、发件人标头和模板。我们的团队会帮助您在入职期间进行注册。

开始使用

在几分钟内发送您的第一条短信

创建一个帐户,获取您的访问密钥并提出您的第一个请求。