Go-Vikunja API中过滤器字段大小写规范的说明

在Go-Vikunja API项目中，开发者在使用任务过滤器时需要注意一个重要细节：API返回的字段名称采用蛇形命名法(snake_case)，而前端文档中展示的是驼峰命名法(camelCase)。这个差异在实际开发中可能会造成一些困惑。

命名规范差异分析

通过实际API调用返回的数据结构可以看到，所有字段都采用了蛇形命名法，例如：

• due_date 而非 dueDate
• project_id 而非 projectId
• cover_image_attachment_id 而非 coverImageAttachmentId

这种命名规范的差异源于不同技术栈的惯例：

• 前端JavaScript生态通常偏好驼峰命名法
• 后端Go语言生态更倾向于蛇形命名法

实际开发中的影响

开发者在使用API过滤器时需要特别注意：

1. 构造API请求时，过滤器字段名必须使用蛇形命名法
2. 处理API响应时，所有字段名也都是蛇形格式
3. 前端展示层可能需要将字段名转换为驼峰格式

最佳实践建议

为了避免混淆，建议开发团队：

1. 在API文档中明确标注命名规范
2. 考虑在客户端封装转换层，统一处理命名转换
3. 保持前后端命名规范的一致性，减少认知负担

项目维护者已经注意到这个问题并进行了文档修正，这体现了开源项目对开发者体验的持续优化。