跳到主要内容

根据 OpenID 发送事务型邮件

SendEmailByOpenID：根据 OpenID 发送事务型邮件。需在 SmartLink > 内容 > 邮件模版 > 事务 先创建好邮件模版。

POST /api/v3/transactional_email/send_email_by_openid

注意

单个业务默认单日最高发送事务型邮件限额为150万封，QPS（Queries Per Second）为200。事务型邮件接口需要使用专用的 API Key，不能使用系统上现有的 API Key。使用事务型邮件接口前，或需提高发送限额，请提前3个工作日联系 SmartLink 运营人员或邮件联系 SmartLink_service@proximabeta.com。

请求参数​

了解关于查询参数的更多信息，请参见 查询参数。

属性数据类型备注描述
openidstring必填唯一用户 ID（最多20个数字字符）
template_codestring必填模版 ID
需先创建好 事务型邮件模版
variablesobject选填变量值替换，用于替换模板内容中 {{}} 符号中的变量。
  • 最多支持100个变量替换。
  • 变量与模板变量须完全一致。
  • 格式说明：
    • object：格式为 { "key":"value" }，key 为变量名称，value 为替换内容
    • value：string 类型，不超过1000字符

请求示例​

curl --request POST "https://openapi.smartlink.intlgame.com/api/v3/transactional_email/send_email_by_openid?gameid=${GAME_ID}&seq=${YOUR_RANDOM_STRING}&sig=${SIGNATURE}&ts=${TS}" \
--header 'Content-Type: application/json' \
--data-raw '{
    "openid": "1012156612344364",
    "template_code": "TR123456",
    "variables": {
      "code": "t1234",
      "code1": "t12345"
    }
}'

响应参数​

属性数据类型描述
codeint返回码
msgstring返回消息
datadata响应消息

data​

属性数据类型描述
transaction_uuidstring请求唯一标识，用于查询邮件递送状态

响应示例​

{
  "code": 0,
  "msg": "Success",
  "data": {
    "transaction_uuid": "6bc92519-5777-43a1-b5bb-6a6a7e24b25b"
  },
  "seq": "{YOUR_RANDOM_STRING}"
}