审批通知变量与模板

发送给联系人的 API 产品订阅通知可以包含动态审批数据。你可以在邮件正文和 Webhook 消息中使用审批变量，以标识申请人、审批记录和 API 产品。

审批变量使用 Go 模板语法，以 {{ 和 }} 分隔，例如 {{ .ApprovalID }}。邮件主题不会解析变量。

审批变量

可使用以下变量：

变量	描述
{{ .ApplicantID }}	提交订阅申请的开发者 ID。
{{ .ApplicantName }}	提交订阅申请的开发者显示名称。
{{ .AppliedAt }}	提交订阅申请的时间，采用 24 小时时间戳格式，例如 2026-07-28 14:30:45。
{{ .ApprovalID }}	审批记录 ID。
{{ .ResourceID }}	与订阅关联的 API 产品 ID。
{{ .ResourceName }}	与订阅关联的 API 产品名称。
{{ .Event }}	审批资源类型。对于 API 产品订阅通知，该值为 api_product_subscription。

API 产品上配置的通知事件（例如 subscription_approval_created 或 subscription_approval_accepted）决定何时发送通知。该生命周期事件不会作为模板变量公开。

邮件正文模板

以下示例创建纯文本邮件正文：

审批申请 {{ .ApprovalID }}

申请人：{{ .ApplicantName }} ({{ .ApplicantID }})
API 产品：{{ .ResourceName }} ({{ .ResourceID }})
提交时间：{{ .AppliedAt }}
审批类型：{{ .Event }}

Webhook 消息模板

对于可能包含引号、反斜杠或控制字符的值，请使用 escape 模板函数，以确保渲染后的消息是有效的 JSON。

{
  "applicant": "{{ .ApplicantName | escape }}",
  "applicant_id": "{{ .ApplicantID }}",
  "timestamp": "{{ .AppliedAt }}",
  "approval_id": "{{ .ApprovalID }}",
  "resource_id": "{{ .ResourceID }}",
  "resource": "{{ .ResourceName | escape }}",
  "event": "{{ .Event }}"
}