郵箱服務

郵件發送與虛擬郵箱收發能力。當前接入 3 條線路,後續可繼續擴展更多平臺/線路。

/api/email/

服務說明

郵箱服務把「發信」和「收信」拆成三條線路:郵箱 v1 用平臺郵箱發送業務郵件,適合驗證碼、通知、告警等場景;VMEmail 與 VMEmail(mail.cx) 提供臨時郵箱(虛擬郵箱)能力,可隨機生成一個郵箱地址並接收來信,常用於註冊驗證、接口聯調、自動化測試等需要一次性郵箱的場合。

三條線路的認證口徑不同:VMEmail 線路為開放接口,可不帶簽名直接調試;郵箱 v1 與 mail.cx 線路需要項目簽名。

臨時郵箱的收件是長輪詢:沒有新郵件時請求會掛起約 25 秒後返回空列表,屬正常行為,請不要按短超時判定為失敗;郵件有留存期限,重要內容請及時取回。

郵箱 v1

發送郵件(默認線路) 需簽名

發送文本/HTML 郵件,支持多個收件人。需項目簽名調用。

POST /api/email/v1/send 累計調用 2 次

發送郵件

發送一封郵件,可指定多個收件人。

郵件標題(必填)

郵件正文內容(必填)

收件人郵箱(必填,支持多個)

多值寫法:多個郵箱用逗號或換行分隔,也可通過同一字段多次傳遞

  • 收件人支持兩種寫法:同一字段重複傳多次,或單個字段內用逗號分隔。
  • 成功返回 data 含 subject / recipients / count;發送失敗歸為外部服務錯誤。
小影API · 通用 API 聚合服務