联系解决方案提供商支持人员的指南

告诉我们你想做什么，发生了什么，以及导致它的步骤。

对于 SP-API 错误，请提供一个受影响呼叫的以下详细信息：

• 完整端点，包括主机和路径以及 HTTP 方法
• API 名称、版本和操作
• 呼叫的请求 ID 和 UTC 时间戳
• HTTP 状态码和完整的错误响应
• 您的应用程序编号、商城编号和 SP-API 区域
• 您正在致电的卖家的卖家代币
• 该呼叫是否是沙盒请求
• Feeds API 或报告 API 问题的上传数据编号或报告编号，或者商品信息 API 问题的提交编号
• 请求和响应标头和正文，每个凭证值都替换为

我们建议在 Postman 中重现调用，它会显示问题是否在您的应用程序之外仍然存在。 要收集详细信息，请打开 Postman 控制台，选择请求，然后展开请求和响应。

将详细信息复制到.txt 文件中，并在<Redacted>附加之前将每个凭据值替换为。 要进行设置，请转到使用 Postman 作为销售合作伙伴 API 模型。

如果错误发生在网站或门户页面（例如解决方案提供商门户）上，请附上记录错误的已清理过的 HAR（HTTP 存档）文件。 HAR 文件记录页面加载时浏览器的网络活动。
要在谷歌浏览器中录制一个，请执行以下操作：

1. 打开隐身窗口，然后转到发生错误的页面。 暂时不要重复失败的操作。
2. 打开开发者工具（Windows 上为 F12，Mac 上为 Cmd+Option+I），然后选择 “网络” 选项卡。
3. 选择 “保留日志”，然后单击 “清除” 以开始干净的录音。
4. 重复导致错误的步骤。
5. 右键单击记录的行，然后选择 “全部复制为 HAR（已清理）”。 将结果粘贴到纯文本文件中，并以.har 结尾保存。

已清理选项会删除 Cookie 和登录令牌。 它不会删除您在页面中键入的任何内容。 除非需要重现错误，否则在录制时请勿输入真实的密码、付款信息或个人身份证。 有关详细步骤，请参阅如何通过浏览器为 AWS Support 案例创建 HAR 文件和控制台日志？

请勿在案例、附件或屏幕截图中包含刷新令牌、访问令牌、受限数据令牌、客户机密、AWS 证书、授权标头、Cookie 或签名 URL。 如需指导，请转至保护敏感凭证。

告诉我们您尝试了哪些解决方案以及为什么它们不起作用。 这样我们就不会建议你已经排除的东西，有时对你的一个步骤稍作修改就能解决这个问题。

• 不太有用：我们已经尝试了几种方法，但没有任何效果。
• 更有帮助：我们按照 [页面 URL] 上的步骤进行操作，最后一步返回错误 XXXX。

告诉我们您想要实现的目标，并附上完整的错误消息。 单行问题通常会导致后续问题，这会减慢解决速度。

• 没那么有用：我无法收到订单。 我该怎么办？
• 更有帮助：当我从 Postman 的 Orders API 中调用 getOrders 时，我收到 “错误：参数无效”。 时间戳为 YYYY-MM-DD HH: MM UTC，请求编号为 XXXXXXXX。 我想检索过去 24 小时内创建的所有订单。

我们会审查所有可能的原因，包括调用方法、缺少权限和临时服务问题。 我们可能还会建议另一种方式来实现您的目标。

打开案例时，请附上错误日志和屏幕截图。 这是缩短解决问题时间的最快方法。 如果您更改了日志格式，请告诉我们更改了什么。 在附加日志或屏幕截图之前，请检查它是否显示任何凭据。

• API 类型：选择您的问题所涉及的 API 类型。
• 问题类型：选择适合您问题的类别。
• API 部分：如果您选择 API 错误作为问题类型，请选择您的问题所涉及的 API。
• 请描述问题：按照描述您的问题中的指导进行操作。
• 相关卖家或开发者 ID：输入存在问题的卖家或开发者 ID。
• 涉及的市场：输入问题发生的商店。
• 相关的 API 操作：输入您正在调用的操作，例如 getOrders。
• SP-API/MWS 应用程序 ID：输入您的应用程序 ID。

一次只能由一名团队成员处理一个案例，因此在不同的案例中可以更快地回答不相关的问题。 例如，打开一个关于检索数据的案例，另一个关于速率限制的案例。 在一个案例中保留密切相关的问题。 我们的团队成员可能会建议将案件分开。

如果您询问已删除的资源，我们可能无法全面调查原因。

失败是不可预测的，也是不可避免的。 尽管我们的技术支持团队努力分析原因并减少基础设施故障的发生，但很难完全防止故障的发生。

因此，我们推荐 “失效设计”（针对故障而设计）。

我们不提供失败的详细解释。 这是因为我们认为，提供有关故障原因的详细信息不会影响客户的变通方案，对于解决客户的问题也不是必不可少的。 相反，我们的目标是向您展示如何正确利用我们的监控服务并确定主恢复的优先顺序，从而快速解决您的问题。

性能取决于您的环境和工作负载，因此我们无法提供一般基准。 我们建议在您自己的环境中测量性能。

在您的支持案例中分享对新功能或改进的请求，我们会将其转交给开发团队。 我们不能承诺构建请求或在请求生成时通知您，但您的反馈可以帮助我们改进。

如果我们的回复解决了您的问题，或者您自己解决了问题，请记下该问题的解决方案并将其关闭。 分享有效的方法，包括我们没有建议的任何修复方法，可以帮助我们为其他开发者解决类似的问题。