Magento REST API:如何确定API基础URL?
确定Magento 2 REST API正确基础URL的方法
这个问题核心在于Magento 2 REST API URL里的<store_code>参数,我来一步步帮你理清:
- 理解URL结构逻辑:Magento 2 REST API的标准格式是
rest/<store_code>/V1/[endpoint],这里的<store_code>对应你后台配置的商店视图代码。官方示例里的default只是默认商店视图的通用代码,但不是所有店铺都用这个值。 - 查看你的商店视图代码:
- 登录Magento后台,进入
商店 > 所有商店(Stores > All Stores) - 在列表里找到你要访问的商店视图,查看「代码」(Code)列的内容——这个就是你需要放在URL里的
<store_code> - 比如有些店铺会把默认商店代码改成
base或者自定义名称,这时候用default自然会报错
- 登录Magento后台,进入
- 为什么省略
<store_code>能生效?
当你的系统只有一个商店视图,且配置允许默认访问时,Magento会自动将rest/V1/[endpoint]映射到默认商店视图。但这是个简化场景,多商店视图环境下必须明确指定正确的store_code - 排查你遇到的错误原因:
你用/rest/default/V1/directory/countries报错,大概率是这两个原因之一:- 你的店铺默认商店视图代码不是
default - 你的API凭证没有关联到
default这个商店视图的访问权限
- 你的店铺默认商店视图代码不是
- 验证方式:
可以发送GET请求到rest/V1/store/storeViews(如果你的API凭证有权限的话),返回的JSON数据里会列出所有商店视图的code字段,直接拿这个值替换URL里的对应部分就可以了
内容的提问来源于stack exchange,提问作者user982124
相关产品推荐
相关产品推荐

