用途：通过 curl 调用 Telnyx Email API，完成事务邮件发送、批量发送、定时投递、模板渲染、地址校验与投递事件跟踪，适用于通知、告警和自动化流程。
主要能力：POST /v2/email_messages 单发邮件，字段含 from、to、cc、bcc、reply_to、subject、html_body、text_body、headers、attachments、tags、metadata、tracking_settings、template_id、template_variables、scheduled_at、sandbox_mode 等；POST /v2/email_messages/batch 批量发送 1–50 条；DELETE /v2/email_messages/{id}/schedule 取消已排期邮件；GET /v2/email_messages 及详情查询；GET .../events 与 .../recipients 查看事件与收件人状态；模板 CRUD 与 render 接口；域名级 webhook 订阅投递事件。
用法与关键约束：需先 export TELNYX_API_KEY="..."，用 Authorization: Bearer 认证；base URL 为 https://api.telnyx.com/v2。示例用 curl --fail-with-body，需从响应提取 ID 时依赖 jq。分页用 page_size（默认 25，最大 100）与 page_cursor。邮件正文以 Base64 内联放 JSON，整体请求体上限 8,000,000 字节。批量接口始终返回 207，需同时解析成功与错误数组。Idempotency-Key 仅部分端点支持。scheduled_at 为过去或非法值会静默立即发送；批量不支持 in_reply_to_message_id、reply_to_all、forward_of_message_id。webhook 用 Ed25519 验签，需基于 telnyx-timestamp 与原始 body，事件 ID 去重并在 10 秒内返回 2xx。
限制：429 可能表示信誉暂停或每日策略限制，需读 .errors[0].code/detail 再决定是否重试；两个删除消息路由标注为暂不可用；订阅事件枚举与可轮询事件枚举不同。缺失信息未提供。