Skip to main content
POST
通知成员

授权

app_key
string
query
必填

在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。

请求体

application/json

邮件通知成员请求

subject
string
必填

邮件主题,按原样使用。必填,1–200 个字符;换行会被替换为空格,首尾空白会被去除。

Required string length: 1 - 200
html
string
必填

邮件正文,HTML 片段(无需 <html>/<head>/<body> 包裹),即收件人看到的完整邮件正文。必填,原始 UTF-8 内容不超过 102,400 字节(更大的正文会被常见邮件客户端截断),且清洗后不能为空。<script>、<meta>、<link>、<base> 标签及所有 on* 事件处理属性会在发送前被静默移除——邮件客户端本就不会执行它们;内联 style 属性按原样保留。<style>、<svg>、<iframe>、<object>、<embed>、<form>、<input>、<button> 标签,src 缺失或不是 https(包括 data:)的 <img>,以及 href 不属于 http、https、mailto 的 <a>,会被直接拒绝而非静默清洗:请求会返回 400,而不是悄悄改变收件人看到的内容。

Maximum string length: 102400
person_ids
integer<int64>[]

收件人成员 ID 列表。可选,最多 20 个,不可重复;省略或为空时仅发送给调用方本人。

Maximum array length: 20

响应

成功

成功响应结构。2xx 响应中 request_id 标识本次调用(同时出现在 Flashcat-Request-Id 响应头中),data 为接口业务 payload。失败响应使用不同结构,参见 ErrorResponse。

request_id
string
必填

本次请求的唯一 ID,也会在 Flashcat-Request-Id 响应头中返回。反馈问题时请一并附上。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object
必填

邮件通知成员响应