发送短信消息

概述

短信发送 API 让您在一次请求中向一个或多个收件人发送事务性或营销短信。您可以为所有收件人使用全局消息和个性化标签,或按收件人指定内容以实现完全定制的批量发送。 基础 URL: https://api.effilink.co 端点: POST /v5/sms/sends 认证方式: 在请求header中添加ApiKey来进行认证

短信内容必须匹配已在相关运营商或监管机构注册的预审模板。不符合已审核模板的消息可能会被拒绝。每次请求最多 100 位收件人。

内容优先级

当提供多个内容来源时,EffiLink 按以下优先级顺序(从高到低)解析每个收件人的最终消息:

优先级	来源
1(最高)	`toList[].templateName` — 每个收件人模板
2	`toList[].content` — 每个收件人内联内容
3	`templateName` — 全局模板
4(最低)	`content` — 全局内联内容

请求参数

全局参数

string

短信正文,包括您的品牌签名,适用于所有收件人。支持个性化标签(例如 {{code}}、{{name}})。除非提供 templateName,否则必填。示例:[YourBrand] Your verification code is {{code}}. Valid for 5 minutes.

string

已全局注册的短信模板名称,作为所有收件人的消息正文。当同时提供时,优先于全局 content 字段。

object

应用于所有收件人的个性化标签值键值映射。当同时存在时,被每个收件人的 params 覆盖。

{ "code": "123456" }

array[object]

必填

收件人对象数组。每次请求最多 100 项。

显示 toList[] 属性

string

必填

收件人电话号码。国际号码请包含国家代码(例如日本为 +818000012345,中国为 18800006666)。

string

每个收件人的短信正文。为此收件人覆盖全局 content 字段。优先级低于 toList[].templateName。

string

每个收件人的模板名称。对该收件人,此项优先级高于所有其他内容来源。

object

每个收件人的个性化标签值。为此收件人覆盖全局 params。

{ "name": "Alice", "orderId": "ORD-001" }

boolean

设置为 true 以沙箱模式运行。请求会被处理和验证,但不会实际投递任何短信。

响应

int

HTTP 风格的状态代码。成功时为 200。

string

人类可读的状态消息。成功时为空字符串。

示例:简单批量发送

使用全局模板和共享的个性化值向多位收件人发送相同消息。

curl --request POST \
  --url https://api.effilink.co/v5/sms/sends \
  --header 'Content-Type: application/json' \
  --header 'ApiKey: YOUR_API_KEY' \
  --data '{
    "content": "[YourBrand] Your verification code is {{code}}. Valid for 5 minutes.",
    "params": {"code": "123456"},
    "toList": [
      {"mobile": "18800006666"},
      {"mobile": "18800008888"}
    ]
  }'

两位收件人都将收到:

[YourBrand] Your verification code is 123456. Valid for 5 minutes.

示例:个性化批量发送

通过为每个收件人提供 params,向每位收件人发送独特消息。

curl --request POST \
  --url https://api.effilink.co/v5/sms/sends \
  --header 'Content-Type: application/json' \
  --header 'ApiKey: YOUR_API_KEY' \
  --data '{
    "content": "[YourBrand] Hi {{name}}, your order {{orderId}} has shipped.",
    "toList": [
      {"mobile": "18800006666", "params": {"name": "Alice", "orderId": "ORD-001"}},
      {"mobile": "18800008888", "params": {"name": "Bob", "orderId": "ORD-002"}}
    ]
  }'

每位收件人收到个性化消息:

18800006666:[YourBrand] Hi Alice, your order ORD-001 has shipped.
18800008888:[YourBrand] Hi Bob, your order ORD-002 has shipped.

响应示例

{
  "code": 200,
  "message": ""
}

事务性邮件

营销邮件

短信

联系人与名单

Webhooks

身份验证

发送短信消息

概述

内容优先级

请求参数

全局参数

响应

示例:简单批量发送

示例:个性化批量发送

响应示例

​概述

​内容优先级

​请求参数

​全局参数

​响应

​示例:简单批量发送

​示例:个性化批量发送

​响应示例

概述

内容优先级

请求参数

全局参数

响应

示例:简单批量发送

示例:个性化批量发送

响应示例