在尝试使用Prestashop 1.7 API时，开发者可能会遇到“401 - unauthorized”错误，这表明API密钥验证失败。通常，这并非密钥本身的问题，而是服务器配置未能正确传递Authorization头部信息给dispatcher.php。 本文将提供一个解决方案，通过修改.htaccess文件，确保API密钥能够被正确识别和处理。
问题分析
当Prestashop安装在某些环境中（例如AWS Lightsail），默认的.htaccess配置可能无法正确传递Authorization头部。dispatcher.php是Prestashop API的核心处理文件，它依赖于Authorization头部中的API密钥进行身份验证。如果该头部信息缺失或不正确，就会导致401错误。
解决方案：修改 .htaccess 文件
解决此问题的关键在于确保.htaccess文件能够正确捕获Authorization头部，并将其传递给dispatcher.php。需要在API重写规则之后添加以下代码：
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule . - [E=HTTP_AUTHORIZATION:%1]具体步骤
使用文本编辑器打开位于Prestashop根目录下的.htaccess文件。
找到API重写规则，通常以RewriteRule ^api(?:/(.*))?$ %{ENV:REWRITEBASE}webservice/dispatcher.php?url= [QSA,L]开头。
-
紧随其后，添加上述两行代码：
RewriteRule . - [E=REWRITEBASE:/] RewriteRule ^api(?:/(.*))?$ %{ENV:REWRITEBASE}webservice/dispatcher.php?url=$1 [QSA,L] RewriteCond %{HTTP:Authorization} ^(.*) RewriteRule . - [E=HTTP_AUTHORIZATION:%1] 保存.htaccess文件。
代码解释
- RewriteCond %{HTTP:Authorization} ^(.*)：此行代码检查是否存在Authorization HTTP头部，并将其内容捕获到反向引用%1中。
- RewriteRule . - [E=HTTP_AUTHORIZATION:%1]：此行代码创建一个名为HTTP_AUTHORIZATION的环境变量，并将%1（即Authorization头部的内容）赋值给它。
注意事项
- 在修改.htaccess文件之前，务必备份原始文件，以便在出现问题时可以恢复。
- 确保你的服务器启用了mod_rewrite模块。
- 修改.htaccess文件后，可能需要重启Apache服务器或刷新其配置。
- 确认Prestashop后台的Webservice API已启用，并且密钥已生成并激活。
- 检查你的API请求是否正确设置了Authorization头部，例如：Authorization: Basic YOUR_API_KEY。
总结
通过在.htaccess文件中添加适当的重写规则，可以解决Prestashop API的401错误，确保API密钥能够被正确传递和验证。 请务必仔细检查每个步骤，并根据你的具体服务器环境进行适当调整。如果在实施这些步骤后仍然遇到问题，请检查服务器日志以获取更多详细信息。
