Polarsource项目文档更新：适配器参数从productId改为products的正确用法

在开源项目Polarsource的日常维护中，我们发现了一个需要及时修正的文档问题。该问题涉及API适配器查询参数的命名规范，原先文档中使用的productId参数已被更新为products参数，但相关文档尚未同步更新。

对于开发者而言，API参数的命名一致性至关重要。在Polarsource项目的早期版本中，确实使用productId作为查询特定产品的参数名称。但随着项目架构的演进和功能扩展，开发团队决定将参数名改为更符合RESTful规范的复数形式products，这既保持了命名的一致性，也更好地反映了API的实际行为。

这一变更带来了几个技术优势：

1. 语义更清晰：复数形式明确表示该参数可以接受多个产品ID
2. 扩展性更好：为未来支持批量查询预留了设计空间
3. 符合行业惯例：与主流API设计规范保持一致

在实际开发中，如果开发者仍然按照旧文档使用productId参数，可能会导致API调用失败或返回意外结果。正确的做法应该是使用products参数，例如：

GET /api/v1/products?products=12345,67890

对于刚接触Polarsource项目的新开发者，理解这一变更尤为重要。项目维护团队已经及时更新了相关文档，确保开发者能够获取准确的信息。同时，这也提醒我们：

1. API文档应与代码实现保持同步
2. 参数命名应遵循一致的规范
3. 重大变更应有清晰的版本说明

作为最佳实践，开发者在集成Polarsource API时应当：

1. 始终参考最新官方文档
2. 关注项目的变更日志
3. 在测试环境中验证API行为
4. 考虑实现参数兼容处理逻辑

这次文档更新虽然只是修改了一个参数名称，但反映了开源项目持续改进的过程，也体现了Polarsource团队对开发者体验的重视。对于技术团队而言，保持文档的准确性是确保项目健康发展的关键因素之一。