fruugo产品api中文版202501
<p>[TOC]</p>
<p>[点击查看官方在线API文档](<a href="https://developer.fruugo.com/#tag/products-v1/operation/patchProducts">https://developer.fruugo.com/#tag/products-v1/operation/patchProducts</a> "点击查看官方在线API文档")
[fruugo中国站买家端](<a href="https://www.fruugochina.com/">https://www.fruugochina.com/</a> "fruugo中国站")</p>
<h3>Fruugo Retailer REST API 让零售商可以做这些事情</h3>
<ul>
<li>把产品和SKU放到Fruugo的在线市场里去卖。</li>
<li>查看自己在Fruugo上的产品和SKU。</li>
<li>看看SKU的库存还有多少，如果需要的话，可以更新库存数量。</li>
<li>查看SKU的价格，也可以根据需要调整价格。</li>
<li>查看SKU在Fruugo上的状态，比如是不是还在卖，有没有问题之类的。</li>
</ul>
<h3>Fruugo Retailer REST API 总结</h3>
<p>Fruugo Retailer REST API 帮助零售商用电脑程序来管理他们在Fruugo市场上的产品和库存。具体来说，它可以做到：</p>
<ul>
<li><strong>提交产品和SKU</strong>：零售商可以把新产品和库存单位放到市场里去卖，这样顾客就能看到并购买这些产品了。</li>
<li><strong>检索产品和SKU</strong>：零售商可以随时查看自己在市场上的所有产品和库存单位的详细信息，比如产品描述、图片等。</li>
<li><strong>库存管理</strong>：零售商可以实时查看库存情况，如果发现某个产品的库存少了，就可以及时补充，避免因为缺货而影响销售。</li>
<li><strong>价格管理</strong>：零售商可以根据市场情况或者促销活动来调整产品的价格，比如搞个促销活动，把价格降下来吸引顾客。</li>
<li><strong>状态查询</strong>：零售商可以查看产品在Fruugo上的状态，比如产品是不是还在正常销售，有没有遇到什么问题，这样就能及时处理，保证销售顺利进行。</li>
</ul>
<h4>请求和响应</h4>
<ul>
<li><strong>X-Correlation-ID</strong>：给你的请求贴上一个标签，这样服务器就能知道这个请求是谁发的。</li>
<li><strong>参数和数据</strong>：你请求时要告诉服务器的信息，比如你想买什么，数量多少，这些信息都放在一个“包裹”里，用JSON格式打包好，然后一起发送给服务器。</li>
</ul>
<h4>测试请求</h4>
<ul>
<li><strong>测试商户账户</strong>：在Fruugo的系统里给你准备了一个“试用版”的账户，你可以用它来测试API，但不会影响到真实的数据。</li>
<li><strong>模拟运行状态</strong>：在这个状态下，你发的请求不会真的影响到Fruugo的系统，就像在玩模拟游戏一样，你可以放心地测试。</li>
<li><strong>第三方API客户端</strong>：比如Postman，就是一个工具，你可以用它来发送请求，测试API的功能。</li>
</ul>
<h4>速率限制</h4>
<ul>
<li><strong>每分钟1000次</strong>：你每分钟只能给Fruugo发1000条信息，不能发太多，否则服务器会忙不过来。</li>
<li><strong>Retry-After</strong>：如果你发请求太频繁了，服务器会告诉你等一会儿再发，这个“等一会儿”具体是多久，服务器会告诉你。</li>
<li><strong>按商户配置</strong>：有时候，Fruugo可以根据不同的商户来调整这个限制，比如有的商户可以发更多的请求。</li>
</ul>
<h4>错误</h4>
<ul>
<li>
<p><strong>API使用标准的HTTP状态码来指示API调用的成功或失败</strong>：对于验证错误，响应的主体将以以下示例格式的JSON呈现</p>
</li>
<li>对于超出速率限制的情况，示例格式如下
<pre><code>{
&quot;status&quot;: 429,
&quot;reason&quot;: &quot;Too Many Requests&quot;,
&quot;method&quot;: &quot;GET&quot;,
&quot;path&quot;: &quot;/v1/Products&quot;
}</code></pre></li>
</ul>
<h4>事件通知</h4>
<p>对于所有需要在Fruugo系统中进一步基于队列处理的异步请求（如创建/更新或获取所有产品/SKU），在提交请求时，你最初会收到一个202 Accepted响应。一旦请求被处理，我们会向你选择的Webhook端点提交进一步的响应，以便在你的系统中进行后续处理</p>
<ul>
<li><strong>异步请求</strong>：当你向Fruugo提交一个请求（比如创建或更新产品信息）时，这个请求可能需要一些时间来处理，因为它要排队等待处理。</li>
<li><strong>202 Accepted响应</strong>：当你提交请求后，Fruugo会先给你一个“收到”的确认，告诉你请求已经收到了，正在处理中。</li>
<li><strong>Webhook端点</strong>：这是一个你指定的网址，Fruugo会在请求处理完成后，自动向这个网址发送一个通知。这个通知会告诉你请求处理的结果，是成功了还是出错了。</li>
<li><strong>无需轮询</strong>：因为Fruugo会主动给你发送通知，所以你不需要不停地去检查请求的状态，就像不需要一直问朋友“你回复了吗？”一样</li>
</ul>
<h4>删除产品或SKU</h4>
<p>目前无法通过我们的API直接删除产品或SKU。然而，如果你希望某个产品或SKU不再被列出销售（并且你以后也不打算再卖它），请按照以下步骤操作：</p>
<ul>
<li>将该产品/SKU的库存数量(stockQuantity)值更新为0。</li>
<li>将该产品/SKU的库存状态(stockStatus)值更新为NOTAVAILABLE</li>
</ul>
<h4>更多信息</h4>
<p>Fruugo有一个专门的“知识库”或“帮助手册”，叫做“零售商维基”。这个维基里有很多有用的信息，帮助商户更好地使用Fruugo的平台。例如，Fruugo的类别分类体系就包含在这个维基中。</p>