EvolutionAPI聊天联系人查询接口where参数问题解析

在EvolutionAPI项目的2.2.3版本中，开发者发现/chat/findContacts接口存在一个值得注意的行为差异。该接口设计用于查询即时通讯应用中的联系人列表，但实际使用中发现其where过滤参数存在实现与文档不符的情况。

问题现象

开发者在使用该接口时，尝试通过where参数中的id字段进行联系人筛选，但发现无论传入什么过滤条件，系统都会返回全部联系人数据。这表明where参数中的id过滤条件未被正确应用。

深入分析

经过进一步测试验证，发现该接口实际上支持的是remoteJid字段而非id字段的过滤。这是一个典型的接口实现与文档描述不一致的情况。正确的过滤参数格式应为：

{
  "where": {
    "remoteJid": "[e-mail]"
  }
}

功能建议

基于此发现，我们建议开发者社区关注以下几点：

1. 参数兼容性：虽然文档显示支持id字段过滤，但实际应使用remoteJid字段
2. 功能扩展：当前过滤条件支持较为有限，建议增加对时间范围(createdAt/updatedAt)等更多字段的支持
3. 操作符丰富：未来可考虑引入>=、<=等比较操作符，增强查询灵活性

最佳实践

对于正在使用该接口的开发者，建议：

• 优先使用remoteJid作为过滤条件
• 关注项目更新日志，及时获取接口变更信息
• 在实际调用前进行充分测试验证

项目维护团队已确认正在更新相关文档，开发者可以期待后续版本中更完善的过滤功能支持。这类接口行为与文档的差异在API开发中并不罕见，体现了持续集成和文档同步的重要性。