第 28 章 账单 API
Billing API 提供了一种方式来自动化常见计费流程。
Billing API 的所有端点均可在管理门户的 Documentation(?)> 3scale API Docs > Billing API 下找到。
Billing API 需要有效的访问令牌，它满足以下要求：
- 它应该属于提供程序帐户的 admin 用户，或者具有"Billing"权限的成员用户。
- 它应包含"Billing API"范围。
请注意，当需要发票 ID 作为参数时，它指的是发票 ID，而不是 友好发票 ID。
API 端点的 XML 响应大多自我解释，Invoice 的字段表示的信息与 web 和 PDF 表示法中的信息相同。
响应中的一些显著字段：
- creation_type ：对于手动创建的发票的 'manual'，或 3scale 自动账单流程创建的发票的 'background'。
- provider ：API 提供程序（管理员帐户）的详细信息，对应于发票的 Issued by 部分。
- buyer ：开发人员帐户的详细信息，对应于发票的 Issued to 部分。
发票的 XML 表示法还包括 line-items 字段下的行项目列表。
对于某些行项目，通常自动创建的项目，除了预期名称、描述、数量和成本价格外，您可以看到以下内容：
type：行项的类型，可以是以下值：-
LineItem::PlanCost- 用于固定计划成本的行项。 -
LineItem::VariableCost- 用于行项目，用于变量成本。
-
-
metric_id: 用于变量成本行项目 - 成本关联的指标的 ID。 -
contract_id：与成本关联的服务或应用程序的 ID。
