快速上手使用 Sakari SMS API 的完整指南

在本文中，我们将为您详细介绍如何快速上手使用 Sakari SMS API，包括身份验证、发送消息以及验证消息接收的具体步骤。通过本文，您将能够轻松掌握 Sakari SMS API 的基本操作。

前置准备

在开始之前，请确保您已准备好以下内容：

1. Sakari 账户：如果您尚未注册，可以访问以下网址创建账户：https://hub.sakari.io/signup
2. API 调用工具：例如 curl、Postman 或其他替代工具。
3. 接收短信的设备：一部能够接收短信的手机，且具备有效的工作电话号码。

步骤 1 – 身份验证

在使用 Sakari SMS API 之前，您需要先完成身份验证。以下是具体操作步骤：

1. 获取 API 凭据
   登录 https://hub.sakari.io，点击右上角的“齿轮”图标，进入账户详细信息页面。在页面底部，您将看到“API 证书”部分。如果尚未请求凭据，请点击“请求凭据”按钮以生成账户 ID 和 API 凭据，并妥善记录这些信息。

2. 请求令牌
   使用您喜欢的工具或编程语言，向 https://api.sakari.io/oauth2/token 端点发出请求，以获取访问令牌。

3. 示例响应
   成功请求后，您将收到如下格式的响应：

   {
   "access_token": "your_access_token_here",
   "token_type": "Bearer"
   }

   请记录 access_token 的值，后续步骤将需要用到。

身份验证示例代码段

以下是使用 curl 进行身份验证的示例代码：

curl -X POST 
https://api.sakari.io/oauth2/token 

步骤 2 – 发送消息

完成身份验证后，您可以使用 API 发送短信，无论是一条消息还是成千上万条消息。以下是具体操作步骤：

1. API 参数

   • 联系人列表：包含需要发送短信的目标号码。
   • 消息模板：可以是静态消息，也可以通过占位符动态插入联系人数据。

2. 发送请求
   使用步骤 1 中获取的账户 ID 和访问令牌，向 https://api.sakari.io/v1/accounts/%ACCOUNT_ID%/messages 端点发出请求。请确保替换以下占位符：

   • %ACCOUNT_ID%：您的账户 ID。
   • %ACCESS_TOKEN%：您的访问令牌。
   • %MOBILE_NUMBER%：目标手机号码（需为国际格式，例如 +13471234567）。

发送消息示例代码段

以下是发送消息的示例代码：

curl -X POST 
https://api.sakari.io/v1/accounts/%ACCOUNT_ID%/messages 
-H 'Authorization: bearer %ACCESS_TOKEN%' 
-H 'Content-Type: application/json' 
-d '{
 "contacts": [{ "mobile": {"number": "%MOBILE_NUMBER%"}}],
 "template": "Congratulations! You have sent your first text message"
}'

注意：确保手机号码的格式正确，否则可能导致消息发送失败。

步骤 3 – 验证消息接收

几秒钟后，您应该会在指定的手机号码上收到一条短信。通过这一简单的操作，您已经成功完成了使用 Sakari SMS API 发送消息的流程。

总结

本文为您详细介绍了使用 Sakari SMS API 的基本步骤，包括身份验证、发送消息以及验证消息接收。这只是 Sakari API 功能的冰山一角。通过进一步探索，您还可以学习如何使用模板向每个联系人发送个性化消息，或者安排定时发送和重复发送的任务。

如需了解更多高级功能，请参考相关文档或博客文章。

原文链接: https://sakari.io/blog/text-messaging-sms-api-quickstart