核心用法
Pakat 技能封装了波斯语友好的邮件营销平台 API，通过 curl 命令与 new.pakat.net/api 交互。用户需先设置 PAKAT_API_KEY 环境变量获取自平台后台。
主要功能覆盖五大场景：
- 邮件列表管理：查询、创建、更新邮件列表
- 订阅者操作：添加、更新、删除订阅者，支持自定义字段
- 营销活动：创建、调度、发送营销邮件，支持模板绑定
- 事务邮件：触发式单封邮件发送，支持 HTML base64 编码
- 数据统计：查询活动送达率、打开率、点击率等指标
关键接口模式：GET/POST/PUT/DELETE 配合 X-API-KEY Header，POST 多用 multipart/form-data，PUT 使用 x-www-form-urlencoded。
显著优点
- 波斯语本地化：RTL 排版、波斯日期、本地邮件服务商优化送达率
- 完整功能闭环：从列表管理到发送追踪的全链路覆盖
- 模板系统：支持 HTML 模板复用及参数替换 (
{{ params.key }}) - 调度灵活：营销活动支持客户时区，事务邮件支持 UTC 定时发送
- 安全编码指引：明确建议使用 heredoc 进行 base64 编码，避免 shell 注入
潜在缺点与局限
- 生态局限：主要服务伊朗及波斯语市场，国际邮件服务商兼容性未明确
- 文档完整性：部分高级功能需查阅本地
references/api_reference.md - 时区复杂性：营销活动与事务邮件使用不同时区基准，易配置错误
- 域名验证：事务邮件发件域名需预先验证，增加部署步骤
- 依赖外部凭证：API 密钥泄露风险，无内置轮换机制
适合人群
- 面向伊朗/阿富汗市场的跨境电商运营者
- 需要波斯语邮件模板的本地化营销团队
- 希望自建邮件系统替代 Mailchimp 但需波斯语支持的技术团队
- 已有 Pakat 账户、需自动化集成的工作流开发者
常规风险
- 密钥泄露：
PAKAT_API_KEY明文存储于环境变量，共享环境或日志可能暴露 - 注入风险：尽管文档提示使用 heredoc，用户仍可能误用
echo处理未过滤输入 - 发送声誉：频繁发送或内容不当可能导致域名/IP 被列入黑名单
- 数据合规：需确认是否符合 GDPR 等跨境数据法规，平台位于伊朗境内
- 服务可用性：地缘政治因素可能影响平台稳定性与国际访问