OpenCollective项目PDF服务新增OAuth令牌与个人令牌支持

OpenCollective项目最近对其PDF服务进行了重要升级，新增了对OAuth令牌和个人令牌的支持。这一改进使得开发者能够更灵活地通过API下载PDF文件，为系统集成提供了更多可能性。

功能背景

OpenCollective作为一个开源项目资金管理平台，提供了丰富的财务文档生成功能。其中PDF服务负责生成各类财务凭证，包括交易收据、费用发票等。过去，这些PDF文档主要通过Web界面访问，但在实际业务场景中，许多用户需要通过API直接获取这些文档以便进行自动化处理。

技术实现

此次升级的核心是在PDF服务中增加了对两种认证方式的支持：

1. 个人令牌(Personal Token)认证：通过在请求头中添加Personal-Token字段进行身份验证
2. OAuth令牌认证：通过标准的Authorization请求头进行OAuth认证

开发者现在可以通过以下API端点直接获取PDF文档：

• 交易收据：/receipts/transactions/:transactionUUID/receipt.pdf
• 费用发票：/expense/:expenseUUID/invoice.pdf
• 时间段收据：/receipts/collectives/:fromCollective/:host/:fromDate/:toDate/receipt.pdf

使用场景

这一改进特别适合以下业务场景：

1. 会计系统集成：将收据和发票自动导入QuickBooks、Xero等会计软件
2. 自动化对账：在财务对账流程中自动获取原始凭证
3. 批量下载：定期批量下载特定时间段内的所有收据

技术细节

对于使用旧版数字ID(legacy ID)的情况，开发者可以通过GraphQL查询获取对应的UUID：

{
  expense(expense: { legacyId: 4242 }) {
    id
  }
}

总结

OpenCollective项目此次对PDF服务的升级，显著提升了API的易用性和灵活性。通过支持标准化的认证方式，开发者可以更轻松地将PDF生成功能集成到自己的应用中，实现财务文档的自动化处理。这一改进尤其对需要进行大量财务对账操作的组织非常有价值，可以显著减少手工操作时间。