用途:通过 Twilio SendGrid v3 API 发送事务性邮件和营销邮件,并管理模板、联系人、抑制列表与统计数据。所有请求假定已设置环境变量 SENDGRID_TOKEN,认证方式为 Authorization: Bearer $SENDGRID_TOKEN;基础地址 https://api.sendgrid.com/v3。
主要能力:校验密钥(GET /scopes);发送单封事务邮件与多收件人个性化邮件(POST /mail/send,成功返回 202 且响应体为空,可用 X-Message-Id 响应头跟踪);列出与查看动态模板(/templates);列出退信、屏蔽、垃圾报告、无效邮箱与全局退订等抑制列表(/suppression/*)并删除指定地址(DELETE 返回 204);列出已验证发件人(/verified_senders);营销活动联系人查询与异步新增更新(/marketing/contacts,返回 job_id 后可轮询 /marketing/contacts/imports/<job_id>)、营销列表(/marketing/lists);按日周月聚合统计(/stats)。
使用方式:示例均以 curl 携带 Bearer 头调用,请求体写入 /tmp/sendgrid_request.json 后用 -d @ 提交;日期可用 ISO 8601 或 Unix 时间戳,分页使用 page_size 与 page_token。
限制:from.email 必须是已验证发件人或属于已验证发送域,未验证会返回 403;营销端点位于 /v3/marketing/ 并使用不同限速池;联系人 upsert 为异步;各端点限速不同(如 /mail/send 多数方案约每分钟 600 次),需关注 X-RateLimit-Remaining 与 X-RateLimit-Reset;具体收费与价格暂未提供。可用 zero doctor check-connector 排查连接问题。