SuperAPI AI 工具集

telnyx-email-domains-curl

办公与效率

查看项目

更新于 10-16 04:31

技能介绍

用途:使用 curl 调用 Telnyx v2 REST API,管理邮件发送域名、验证 DNS 记录、检查域名健康度,并配置域名级 webhook。

主要能力:创建、列出、查询、更新、删除邮件域名;获取 API 生成的 DNS 记录(用途含 ownership、spf、dkim、dmarc、mx);触发 DNS 验证并检查聚合健康状态与 usable_for_sending / usable_for_inbound;管理域名级 webhook(列出、创建、查询、更新、删除)及订阅事件白名单。

必要用法:所有请求需带 -H "Authorization: Bearer $TELNYX_API_KEY",JSON 请求另加 -H "Content-Type: application/json",建议使用 --fail-with-body --silent --show-error。创建域名 POST /v2/email_domains 返回 201,保存 .data.id;再 GET /v2/email_domains/{domain_id}/dns_records 获取需发布的记录,在权威 DNS 发布后 POST /v2/email_domains/{domain_id}/verify 触发验证,GET /v2/email_domains/{id}/health 检查健康。webhook 通过 POST /v2/email_domains/{domain_id}/webhooks 配置,需提供 url 和非空 events 白名单。webhook 投递使用 Ed25519 签名,校验 telnyx-signature-ed25519 与 telnyx-timestamp,保留原始请求体,按事件 ID 去重并于 10 秒内返回 2xx。

适用场景:邮件发信域名的开通与验证、DNS 与发信就绪状态检查、投递事件订阅与处理。

限制:共享域名只读,非所有者更新、验证或删除会返回 403(代码 10008);DNS 记录由 API 生成,不提供单条记录的增删改接口;验证请求成功仅表示检查已执行,不代表所有记录通过;已验证域名删除需传 force=true;域名列表支持 offset 或 cursor 分页,webhook 列表仅支持 offset 分页;事件订阅无默认全部行为,PATCH 会替换整个事件列表。域名名称与类型不可修改。更新 DMARC 策略会重置其验证状态。

缺失信息:资料未提供价格、平台支持范围、发送配额等信息。