十月的新品季，做墨西哥站的一批卖家把新品表整理好，上百个 SKU 一起丢进刊登队列，半小时后回头看，成功的不到一半，失败原因只有一句「接口被限流，请稍后重试」。图拍了、类目选了、价格算好了，卡住的是另一个看不见的东西：单位时间里你被允许发多少次。

美客多刊登接口按调用频次放行。日常一二十个链接，感觉不到它的存在；一到批量上新，美客多发品频次限制这堵墙就露出来了。它跟账号权重、类目审核都没关系，靠反复点重试也绕不过去，得从接口配额这一层动手。

图注：妙手ERP 发布记录里，失败原因写明「美客多官方接口限流，请稍后重试」，与账号、类目无关。

一、限流卡在哪：按应用计量，按站点分配

要把美客多发品频次限制说清楚，得先看它的计量方式。美客多全球销售开发者文档把这类报错定义为 HTTP 429 local_rate_limited：在 /global/items 下创建或更新商品时，短时间内的请求量超过允许阈值，系统会做临时阻断，保护服务本身的完整性。文档给出的处理方式是让调用在时间上分散、用带退避的重试、用队列把写操作削峰。

1、按站点独立配置，墨西哥和巴西不是同一把尺子

同一份文档说明，各市场的政策与容量约束不同，速率限制按站点（国家）单独配置。一次多站点刊登里，墨西哥站成功了，巴西站被限住，这种情况很常见。正确的处理是只重试被限的那个站点，别把整批链接重新提交一遍。

2、共享配额：呼得很慢也可能被拦

文档里还解释了一个反直觉的现象：即使调用很少、十分钟才发一次请求，照样可能收到 local_rate_limited。限额看的是时间窗口内的使用量，同时受共享服务配额策略影响。文档特意提到 /marketplace/items/{itemId} 这类端点限制更严，而且不一定是你的应用独占。

走平台公共通道发品，你的上新节奏要和同一份额度里的其他调用者一起排队。

3、旺季更容易撞墙，额度是被摊薄的

美客多发品频次限制在旺季更容易撞上：额度按时间窗口计量，全网调用量一起上去，分到每个应用的那一份自然更紧。这也是为什么同样的批量，九月能顺利发完，十一月就开始报限流。提前把配额这件事处理好，比临到上新日再救火划算。

一次批量被限，损失的不只是这半小时。失败的链接要重新核对主图、属性和价格，人工再走一遍；多站点还得分辨哪个站点过了、哪个没过，重新排一遍提交顺序。这些活都不产生新链接，只消耗人手。

4、先分清是限流还是别的失败

失败提示写「接口限流」的，属于这一篇要解决的问题；写属性缺失、图片不合格、类目不对的，是另一码事，重试多少次都过不去。发布记录里把这两类分开看，才不会把属性问题误判成限流，白白等上几个小时。

二、先保住节奏：减量、排队、换通道

限流不是发品失败的唯一原因，却最容易提前化解。三件事按成本从低到高排，能做的先做。

1、减量：能合并的变体别拆成十几个链接

同一个款的不同颜色和尺码，做成一个链接下的变体，比拆成十几个独立 listing 省事得多。这一条直接压低美客多发品频次限制被触发的概率：十几次调用压成一次，评价和销量也不再被分散到十几个页面里从头攒权重。

2、排队：把一次批量拆成几个小批

美客多刊登任务按站点拆开提交，批与批之间留出间隔。失败列表回来以后只补发被限的那部分，别整张表重来。这样一来，即使撞上 429，损失的也是一个批次，不是一整天的上新计划。

判断自己是不是撞在这道墙上，看两点：发布记录里的失败原因是不是统一写着接口限流；同一批链接里成功的那些，换个时间再发能不能过。两条都对得上，基本可以确认是频次问题，跟链接本身的质量无关。

3、换通道：用自己创建的开发者应用发品

美客多接口配额是按应用单独计算的。卖家在美客多开发者中心建一个属于自己的应用，绑到发品后台，发品走的就是这个应用的额度，不必再和公共通道挤在一起。这条路只对跨境店铺开放，本土店铺用不上。

三、接入自建应用：配额跟着应用走

美客多开发者应用建好之后，要挂到日常发品的后台才算真正生效。妙手ERP 的美客多店铺是在授权模块里统一管的，应用管理也放在同一处，店铺、刊登记录、失败原因能对着看，配置一次之后发品直接走应用额度。

1、额度跟着应用走，不跟着店铺走

店铺授权只是把你后台的数据接进来，美客多开发者应用才是接口调用的身份。绑上应用以后，发品消耗的是这个应用自己的调用额度，和其他卖家的流量分开计算。

2、一个应用能盖多个店铺，但每个店要单独授权

应用添加完成以后，美客多店铺授权还要再走一轮：每个要发品的店铺都得回到应用列表里单独授权一次。这一步跳过，店铺照旧走原来的通道，配额一点没变。

3、应用建得越多，可用的额度越多

妙手ERP 这份教程里提示，单个应用在高频发品下仍可能被限，发品量大的时候建议多建几个应用分别接入，接得越多，可用的美客多接口配额越多。要注意平台对应用数量与调用总量仍有限制，这条路是把通道拓宽，不是把限制取消。

4、全托店要填另一条回调地址

跨境店和全托店在授权回调地址上不是同一条。想让一个应用同时服务两种店，可以在回调地址里把两条都加上，授权时按店铺类型走对应那条。

四、七步配置：从建应用到授权跑通

整个流程建议用 Chrome 完成，中间涉及跳转登录和密钥查看，换个浏览器容易卡在某一步。

1、先把要发品的店铺授权好

进入妙手ERP 的授权店铺，点选 Mercado Libre，再点【添加授权店铺】完成授权。美客多店铺授权必须放在建应用之前，顺序反了，后面的应用授权会失败。

图注：授权店铺页里 Mercado Libre 卡片下方的【添加授权店铺】，建应用前先走这一步。

2、在开发者中心创建应用

打开美客多全球销售开发者中心，进入 My applications，点【Create new application】。

（1）填写基础信息

Name、Short name、Description 按自己的习惯填，Logo 上传一张图片即可。这一页的内容不做审核，填完点【Continue】。

图注：创建应用第一步只填 Name、Short name、Description 和 Logo，此页内容不做审核。

（2）回调地址按店铺类型填

跨境店填 https://erp.91miaoshou.com/api/open/shop_auth/callback?platform=mercadolibre，全托店填 https://erp.91miaoshou.com/api/open/shop_auth/callback?platform=mercadolibreFull。一个应用要同时授权两种店，点【Add Redirect URI】把两条都加进去。

图注：两条回调地址分别对应跨境店与全托店，点【Add Redirect URI】可以追加一条。

（3）OAuth 与业务范围全选

OAuth Flows 三项全勾，PKCE required 不勾选，Business 下面的选项全部勾上。

（4）权限全部开到读写

Permissions 列表逐项选 Read and write。只有 Business metrics 这一项平台仅支持 Read，选 Read 即可。

图注：Permissions 逐项选 Read and write，Business metrics 只有 Read 一个选项。

（5）Topics 每个分组都要 Select all

每个分组点开下拉，点【Select all】把组内权限全部勾上。漏掉一个分组，后面可能某个功能用不了。

图注：Topics 下每个分组点开再点【Select all】，Items、Messages、Prices、Orders 都不能跳。

（6）填消息推送地址并创建

Notification configuration 一栏填 https://erp-msg.91miaoshou.com/open/mercadolibre_custom_app/event，勾选协议、过人机验证，点【Create】。

部分账号在这一栏会遇到 Address must be valid 的红色报错，地址本身没写错，这个提示不影响创建，直接保存即可。

图注：消息推送地址栏出现 Address must be valid 提示时，地址不用改，可以继续创建。

3、复制 App ID 和 Client Secret

回到 My applications，找到刚建的应用，点右侧的扩展图标再点【Edit】。平台可能要求验证码或人脸验证，通过后进入 Application settings，复制 App ID，点眼睛图标显示 Client Secret 再复制。

图注：Application settings 里的 App ID 与 Client Secret，密钥要点眼睛图标才显示。

4、在妙手ERP 里添加应用

回到妙手ERP，在授权店铺页点 Mercado Libre 下的【应用管理】，弹窗里点【添加新应用】，填应用名称，把 App ID 和 Client Secret 粘进对应输入框，点【确定】。

图注：应用管理弹窗里的【添加新应用】，三项分别填应用名称、APPID、Client Secret。

5、退出店铺后台，再回妙手授权

先去美客多店铺后台退出登录，回到妙手ERP 的应用列表，找到刚添加的应用点【授权店铺】，跳转后登录店铺，点【Authorize】。每个要发品的店铺都要单独走一遍，绑过一次不代表全店生效。

图注：应用列表里点【授权店铺】之前，先到美客多后台退出当前店铺登录。

图注：授权页核对应用名与店铺无误后点【Authorize】完成绑定。

6、拿一个小批量做验证

先发五到十个链接，看发布记录里是否还出现限流提示。正常了再往上加量，别一上来就恢复全量。

整套配完大概二十分钟，之后每次上新前只多做一件事：确认要发的店铺都已经授权到应用上。妙手ERP 里这套配置一次长期有效，加店铺、加站点时补一次授权就行。旺季前把这一步做完，美客多发品频次限制就不再是卡上新节奏的那个点，比在失败弹窗前面反复点重试省时间。

五、五个细节：授权顺序与浏览器先排掉

1、浏览器选 Chrome

建应用和授权两步都建议用 Chrome，跳转登录、密钥显示这两处换浏览器容易出岔子。

2、紫鸟浏览器里可能看不到密钥

在紫鸟环境里创建的应用，密钥那一栏有时显示不出来，换一个普通浏览器打开就能看到。

3、添加应用不会自动接管老店铺

应用添加上去只是建立了一个可用通道，已有店铺仍然走原路径，要在应用列表里再授权一次才会切过来。

4、本土店铺用不了这条路

自建开发者应用只对跨境店铺开放，本土店铺绑了也不生效。

5、额度上限仍然在平台手里

多建应用能把自己这条通道拓宽，平台对应用数量、调用总量的限制并没有取消，批量发品该分批还是得分批，该错峰还是得错峰。

常见问题解答FAQ

问：一个应用最多能绑几个店铺？

答：数量上可以绑多个，但每个店铺都要在应用列表里单独点一次授权，跳转登录后按确认才算生效，跳过哪个哪个就不算接入。

问：建应用需要平台审核吗？

答：基础信息那一页不做审核，名称、简称、描述随便填都能进下一步；真正需要人工过的只有最后的人机验证那一关。

问：消息推送地址填对了还是提示报错，要改吗？

答：不用改。那一栏部分账号会出地址校验提示，属于平台侧的显示问题，不影响创建，直接保存即可。

问：授权一直失败，先查哪里？

答：先查顺序。店铺没有提前授权到发品后台就先把应用建了，是这类失败最常见的原因，把顺序倒过来重走一遍基本能解决。

问：全托店和跨境店能共用一个应用吗？

答：一个应用里可以同时挂两条地址，跨境和全托各占一条，两边都能跑，不必分开建。

问：多建几个应用，是不是就不受频次限制了？

答：不能这么理解。应用数量增加带来的是额度叠加，平台对调用总量的管控没变，批量大的时候仍然要拆开提交。

问：授权完成后多久起效？

答：授权成功后即生效。稳妥的做法是先发几个链接试水，确认发布记录里不再出现限流提示，再放全量。

问：本土店铺能用这套方法吗？

答：不能。这条通道只对跨境店铺开放，本土店铺即便绑上应用也不会走独享额度。

数据来源说明

文中关于接口限流机制、站点差异与共享配额的表述，来自美客多全球销售开发者文档《CBT 中的速率限制（429 / local_rate_limited）和共享配额》，该文档更新于 2026 年 5 月 6 日，面向跨境卖家（CBT）的刊登与商品管理接口。

该文档说明的是 HTTP 429 报错的触发条件、按站点独立配置的限额规则，以及共享配额策略对低频调用的影响。文档同时建议以队列削峰、带抖动的指数退避重试处理限流，这属于平台对第三方开发者的技术要求，不构成对单个卖家发品量的承诺。

应用详情、回调地址与权限字段的说明，来自美客多开发者平台的应用管理文档。文中出现的界面按钮名称与操作顺序，随平台后台改版可能变化，以实际页面显示为准；频次上限的具体数值，平台未在公开文档中统一列出，以应用后台与发布记录的报错为准。

文中涉及行业趋势的表述均为公开研究结论转述；带「预计」「约」字样的数据为预测值或估算值，不作为经营承诺。