使用Postman测试KOHA RestAPI持续遭遇认证失败问题求助

核心原因 #

浏览器能正常访问是因为登录后保存了会话Cookie，而Postman默认不会自动继承浏览器的会话状态，你尝试的Basic Auth、OAuth2可能并非Koha当前启用的认证方式。

可行解决步骤 #

1. 复用浏览器会话Cookie #

• 登录Koha权限账号后，在浏览器打开目标API地址
• 按下F12打开开发者工具，切换到Application/存储标签，找到对应Koha域名下的Cookies，复制CGISESSID（或类似会话ID的键值对）
• 在Postman请求的Headers标签里，添加Cookie头，值填CGISESSID=你复制的会话ID
• 重新发送GET请求验证结果

2. 确认Koha API认证配置 #

• 登录Koha后台，进入系统管理 -> 系统参数 -> API
• 检查关键参数：
  • RESTAPIEnabled：需设为Yes
  • AuthType：确认当前启用的认证方式（Session、Basic或OAuth2）
  • 若用OAuth2，需核对OAuth2ClientID、OAuth2Secret和Token URL是否与Postman配置一致，同时确保该客户端有访问patrons接口的权限

3. 正确配置Basic Auth（若启用） #

• 若Koha API启用Basic Auth，需使用Koha专用API账号（并非普通后台登录账号）
• 在Postman的Authorization标签选择Basic Auth，输入API账号的用户名和密码，Postman会自动生成Authorization请求头

4. 指定返回格式请求头 #

• 在Postman请求头中添加Accept: application/json或Accept: application/xml，明确要求返回格式，避免因格式协商失败导致的隐性错误

排查小技巧 #

• 对比浏览器与Postman的请求头：在浏览器开发者工具Network标签复制完整请求头，和Postman的请求头逐一比对，重点检查Cookie、Authorization、Accept等字段的差异
• 开启Koha API日志：在后台启用API请求日志，查看具体认证失败原因，精准定位问题

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