Meilisearch调用getKey()无API key uid返回问题咨询

问题分析 #

调用getKey()方法传入API key后未返回官方文档标注的uid字段，并非接口响应结构变更，核心问题是调用逻辑不符合接口设计规范。Meilisearch的getKey()接口本身确实包含uid字段，问题出在你传入的参数类型错误。

正确获取API key uid的方法 #

• 纠正调用参数：用key的uid而非key值调用
  getKey()接口的设计逻辑是传入目标key的uid来查询详情，而非直接传入key的字符串值。如果用key值调用，接口仅会返回该key的基础权限信息，不会包含uid字段——因为此时接口默认你是通过key值完成身份验证，而非主动查询特定key的完整属性。
• 标准操作流程
  1. 使用**主密钥（Master Key）**调用getKeys()接口，获取所有API key的完整列表，每条数据都会包含uid、key、name等全量字段。
  2. 在列表中定位到你正在使用的API key，提取对应的uid。
  3. 再次用主密钥调用getKey(uid)，传入提取到的uid，此时响应会返回包含uid在内的完整key信息。

验证示例 #

调用getKeys()的响应结构示例：

[
  {
    "uid": "123e4567-e89b-12d3-a456-426614174000",
    "key": "your-target-api-key",
    "name": "Search Access Key",
    "actions": ["search"],
    "indexes": ["*"],
    "createdAt": "2024-05-20T10:30:00Z",
    "updatedAt": "2024-05-20T10:30:00Z"
  }
]

提取uid后调用getKey("123e4567-e89b-12d3-a456-426614174000")，即可得到包含uid的完整响应。

额外排查点 #

若按上述流程操作仍未获取到uid，请检查：

• 使用的Meilisearch版本是否过旧，建议升级至最新稳定版；
• 调用接口时是否使用了具备keys.read权限的密钥（主密钥默认拥有该权限）。

内容的提问来源于stack exchange，提问作者CodeMaster12