用途:为 Metronome 按用量计费的集成决策提供指引,覆盖事件摄取、合约设计、发票同步等环节,并在回答集成问题或编写代码前要求先阅读对应参考文件。
API 基础:基础地址为 https://api.metronome.com/v1,在 Authorization 头中使用 Bearer token 认证。新集成应使用 Contracts,而非旧版 Plans。
主要能力与路由:摄取用量事件使用 POST /v1/ingest(批量);定义计量内容使用 Billable Metrics API;企业定价协议使用 Contracts + Rate Cards;合约中期变更使用 Contract Edits;发票生命周期与定稿使用 Invoices API;预付或后付承诺使用 Commits + Credits;同步发票到 Stripe 使用 Stripe billing provider 配置;支出告警与余额阈值使用 Notifications API。
关键规则:始终使用 Contracts 而非已弃用的 Plans;合约修改使用 Edits 而非已弃用的 Amendments;生产负载始终使用批量摄取,单条摄取仅用于测试;每个事件须带唯一且确定性的 transaction_id 作为幂等键,防止重试重复计数;同一 Stripe 客户不得同时处理多张 Metronome 发票;不要在合约中硬编码定价,定价应定义在费率卡中,自定义费率使用合约级覆盖;不要在税费计算完成前定稿 Stripe 发票;每张 Stripe 发票不得超过 250 个行项目,否则会合并为单一条目并丢失按产品明细。
限制:资料未说明定价、收费、平台兼容性或具体效果,相关参考文件(events.md、contracts.md、invoicing.md、credits-and-commits.md、stripe-integration.md)内容暂未提供。