pakat

📧 波斯语友好邮件营销专家

基于 Pakat 平台的邮件营销 API 文档,支持订阅者管理、营销活动发送及事务性邮件,提供波斯语友好的专业邮件解决方案。

收藏
5.6k
安装
1.7k
版本
v1.1.2
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心用法

Pakat Skill 提供了与 Pakat 邮件营销平台 REST API 的完整交互能力,覆盖邮件营销全生命周期管理。用户可通过标准化的 HTTP 请求管理邮件列表(Lists)和订阅者(Subscribers),执行创建、读取、更新、删除操作;创建并发送营销活动(Campaigns),支持定时调度、模板调用及详细的邮件头配置;发送事务性邮件(Transactional Emails),支持 Base64 编码的 HTML 内容和模板变量替换;实时查询 Campaign 统计数据和投递日志,监控邮件送达率和用户互动情况。所有操作均通过 X-API-KEY 头部认证,采用 RESTful 设计风格,支持分页查询和多种内容格式。

显著优点

该 Skill 最突出的优势是其对波斯语(Persian/Farsi)内容的原生友好支持,填补了中东市场邮件营销工具的生态空白。API 设计遵循标准 REST 规范,使用清晰的资源命名和 HTTP 方法语义,降低了开发者的学习成本。安全方面强制使用 HTTPS 加密传输,敏感凭证通过环境变量管理,避免了硬编码风险。功能层面支持复杂的订阅者状态机(unconfirmed、confirmed、blacklisted 等),提供精细化的列表管理;模板系统灵活,既支持内联 HTML Base64 编码,也支持模板 UID 引用;事务性邮件支持 {{ params.key }} 变量注入,满足个性化邮件需求。

潜在缺点或局限性

首要局限是强平台依赖性,所有功能必须连接 Pakat 云服务(new.pakat.net),无法在内网或离线环境使用,存在服务可用性单点风险。发送域名必须经过平台验证,增加了初期配置复杂度。时区处理存在易混淆点:事务性邮件使用 UTC 时间,而营销活动使用客户配置的时区,可能导致定时发送失误。作为 T3 来源的个人开发者项目,长期维护更新和官方技术支持力度可能不如企业级产品。此外,API 仅针对 Pakat 平台设计,缺乏与其他邮件服务商(如 SendGrid、Mailchimp)的兼容性,迁移成本较高。

适合的目标群体

该 Skill 特别适合面向波斯语市场(伊朗、阿富汗等)的电商企业、内容创作者和营销团队,解决了主流邮件工具对从右至左(RTL)语言支持不佳的痛点。对于需要集成事务性邮件(如订单确认、密码重置、通知推送)的开发者,提供了简洁的 API 封装。中小型企业营销运营人员可通过此工具自动化邮件列表管理,执行精准的会员营销。技术文档编写者和开发者关系团队也可利用其规范的 OpenAPI 规范作为接口文档参考。

使用风险

数据安全风险:虽然传输过程使用 HTTPS,但用户需自行保管 API Key,一旦泄露可能导致邮件账户被滥用发送垃圾邮件。第三方依赖风险:数据存储和邮件投递完全依赖 Pakat 平台,存在数据主权、隐私合规(GDPR 等)及服务终止风险。操作风险:批量邮件发送操作不可逆,误操作可能导致用户骚扰或品牌声誉损失。来源可信度风险:作为个人开发者(T3)维护的项目,存在维护中断、文档过时或安全更新不及时的潜在风险,建议在生产环境使用前进行代码审计。

安全解读

核心用法

Pakat 是专为波斯语/波斯文化市场设计的邮件营销平台,本 Skill 提供完整的 REST API 文档与 curl 示例,覆盖六大核心功能模块:

1. 邮件列表管理 - 创建、查询、修改邮件列表
2. 订阅者管理 - 添加订阅者、管理订阅状态(未确认/已确认/黑名单/退订等七种状态)

3. 营销活动 - 创建定时或即时发送的邮件营销活动,支持 HTML 模板

4. 事务性邮件 - 发送订单确认、密码重置等触发式邮件,支持 base64 编码 HTML 内容

5. 模板管理 - 复用预定义邮件模板,支持 {{ params.key }} 占位符传参

6. 统计与日志 - 查询营销活动投递率、打开率、点击率等核心指标

API 采用标准 HTTP 方法(GET/POST/PUT/DELETE),认证方式为 X-API-KEY Header,支持分页查询(?page=N&per_page=N)。特别注意:HTML 内容需 base64 编码,事务性邮件使用 UTC 时间,营销活动使用客户配置时区。

显著优点

  • 波斯语原生优化:针对 RTL 语言和波斯语字符集提供良好支持,填补 Mailchimp 等国际产品在本地化体验上的空白
  • 纯文档零风险:T-MD 类型 Skill,仅包含 Markdown 文档和 curl 示例,无可执行代码,无供应链攻击面
  • API 设计清晰:RESTful 接口规范,字段命名直观,示例代码可直接复制使用
  • 功能完整度高:同时支持营销邮件(Campaign)和事务性邮件(Transactional),覆盖邮件服务全场景
  • 安全合规:通过 CLS-Certify S 级认证,强制显式配置 API Key,无静默数据收集

潜在局限

  • 地域局限性:Pakat 主要服务伊朗及波斯语市场,服务器地理位置可能影响其他地区访问速度
  • 个人开发者维护:来源可信度 T3 级别,作者 hadifarnoud 为个人开发者,长期维护稳定性存疑
  • 生态整合弱:相比 Mailchimp、SendGrid 等成熟平台,第三方集成和 SDK 支持较少
  • 文档深度:OpenAPI 规范文件存在,但交互式文档和 SDK 生成工具不完善
  • 合规风险:伊朗受国际制裁影响,企业用户需评估跨境数据传输合规性

适合人群

  • 波斯语市场运营者:面向伊朗、阿富汗等波斯语用户的电商、SaaS、内容创作者
  • 独立开发者/小团队:需要轻量级、低成本的邮件营销方案,具备基础 API 调用能力
  • 已有 Pakat 账户用户:需要快速查询 API 用法、复制示例代码的开发者
  • 自动化工作流搭建者:结合 n8n、Make 等工具构建邮件自动化流程的技术用户

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| API Key 泄露 | 中 | 用户需自行保管 `PAKAT_API_KEY`,避免硬编码或误提交至版本控制 |
| 跨境合规 | 中高 | 伊朗制裁背景下,企业用户需评估 OFAC 等法规限制 |
| 服务可用性 | 中 | 区域性服务,国际网络环境下可能出现访问不稳定 |
| 数据本地化 | 低 | 邮件数据存储于 Pakat 服务器,需了解其数据处理条款 |

pakat 内容

references文件夹
手动下载zip · 14.7 kB
api_reference.mdtext/markdown
请选择文件