--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/market/partner-api/doc/en/push-notifications/index.md - https://yandex.com/dev/market/partner-api/doc/ru/push-notifications/index.md - https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/index.md - href: zh/push-notifications/index.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/zh/llms.txt {% note info "API通知与 push-api — 与Yandex合作的旧计划。 市场。" %}   {% endnote %} # 如何使用通知 您可以启用API通知和Yandex。Market会向您发送请求。 [POST 通知书](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/reference/sendNotification.md) 有关[活动]的资料(*notification-type) 每次它发生。 这是一个可选的集成，您不必启用通知。 但是，在他们的帮助下，您将能够快速响应订单的更改，非购买和退款，以及取消订单的请求。 市场仅与使用SSL证书通过HTTPS操作的商店交换数据。 它必须由官方证书颁发机构签名，自签名证书将不起作用。 有关证书颁发机构的信息可以在互联网上找到。 {% note tip "根据IP地址范围检查每个请求。" %} 集成的安全性取决于它。 — 这样，您将确保请求来自Yandex。市场。 市场使用的IP地址范围: * [5.45.207.0/25](*ip-range-5-45-207) * [141.8.142.0/25](*ip-range-141-8-142) * [5.255.253.0/25](*ip-range-5-255-253) {% endnote %} ## 启用集成 {#how-to-start} ![启用集成的屏幕截图](../_images/new-notification.png) 接收Yandex的通知。街市: 1. 在市场上的卖家帐户，点击您的帐户的图标→ **设置** 在左边的菜单中，选择 **Api和模块** →标签 **空气污染指数通知书**. 1. 点击按钮 **启用通知**. 1. 指定通知名称 — 您只需要它来搜索列表中的通知。 1. 选择您是为商家资料还是商店设置通知:
#| || | **通知即将到来** | **配置通知所需的角色** [角色是什么？](https://yandex.ru/support2/marketplace/ru/account/permissions/roles)|| || 办公室 | 适用于所有橱柜店| 内阁所有者或内阁经理 || || 商店 | 对于特定的商店 | 内容管理器以外的任何角色 || |# 1. 选择要接收的通知类型: | **通知书** | **为内阁而来** | **它是为商店而来的** | | ------------------------------------- | ------------------------- | ------------------------- | | 创建订单 | ✔️ | ✔️ | | 更改订单 | ✔️ | ✔️ | | 更改订单状态 | ✔️ | ✔️ | | 取消订单 | ✔️ | ✔️ | | 创建订单取消请求 | ✔️ | ✔️ | | 退款或不购买 | ✔️ | ✔️ | | 更改退款或非购买状态 | ✔️ | ✔️ | | 新检讨 | ✔️ | | | 新评论 | ✔️ | | | 与买家的新聊天 | ✔️ | | | 聊天中的新消息 | ✔️ | | | 争端的开始 | ✔️ | | | 结束争议 | ✔️ | | ⚠️ 如果为商家配置文件配置了与订单相关的通知，则还会通过以下方式发送 FBY-命令。 {% note warning "如果同时为机柜和商店配置了通知" %} 如果您同时启用了机柜和商店的通知 — 燕基科斯.市场将发送 **只有一个通知** 上 URL 那家商店。 通知书 URL 只有在商店未启用此类通知时，才会发送商家的帐户。 {% endnote %} 1. 输入yandex的链接。市场将发送通知。 完整地指定它，包括HTTPS协议。 1. 点击按钮 **插头**. 创建的通知将立即出现在仪表板中，但它们将开始到达。 **2分钟内**. ### 检查集成 {#check} 要检查集成的功能，yandex的。市场将发送请求 [POST 通知书](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/reference/sendNotification.md) 哪里会有一个验证通知在正文中与类型 `PING`. {% cut "请求体示例" %} ```json translate=no { "notificationType": "PING", "time": "2025-01-16T10:09:49.759084017Z" } ``` {% endcut %} 用代码返回响应 `200` 及10秒内的通知处理的信息。 如果传输另一个代码，不正确或数据不足，则不会启用集成。 [可能的错误](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/concepts/error-codes.md#shop-errors) {% cut "响应体的示例" %} ```json translate=no { "version": "1.0.0", "name": "name", "time": "2025-01-16T10:09:49.759084017Z" } ``` {% endcut %} ## 对请求的响应 {#how-to-response} 响应时间为10秒。 * 如果请求正确，则返回代码 `200` 用通知处理的信息。 [响应体](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/reference/sendNotification.md#200-ok) * 如果市场发送了错误的通知，请返回代码。 `400` 与错误的描述。 市场将分析此类响应并完善API。 [响应体](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/reference/sendNotification.md#400-bad-request) * 如果您遇到技术错误，请返回代码。 `500`. [响应体](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/reference/sendNotification.md#500-internal-server-error) 有关请求和响应的详细信息，包括错误，可以在市场上的卖方帐户中查看。 — 点击您的帐户图标→ **设置** 在左边的菜单中，选择 **Api和模块** →标签 **通知日志**. 阅读更多关于这一节 [请求日志](https://yandex.com/dev/market/partner-api/doc/zh/concepts/debug.md). [可能的错误](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/concepts/error-codes.md#shop-errors) ### 商店的API没有响应 {#no-answer} 如果存储不满足十秒超时或请求 [POST 通知书](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/reference/sendNotification.md) 返回一个错误，除了 `400`、市场: * 它停止发送其他通知，直到它收到对有问题的请求的合适响应。 * 重复有问题的查询: 1. 第一个小时的每一分钟。 1. 第一天每15分钟一次。 1. 然后每小时一次。 如果商店的API在发送第一个通知后的14天内不可用，则商店将被禁用。 **从整合**，但继续发布和销售产品。 燕基科斯.市场将取消所有在断开连接之前无法发送的通知，并且不会发送新的通知。 要继续接收通知，请再次连接它们。 有关如何执行此操作的详细信息，请参阅 [通知管理](#manage). ## 通知管理 {#manage} {% note warning "更改通知后" %} 仪表板中的信息将立即更新，但通知将开始到来或关闭。 **2分钟内**. {% endnote %} ![连接集成的屏幕截图](../_images/all-notifications.png) {% cut "要改变" %} 您可以编辑通知的名称和类型，以及发送通知的链接。 要做到这一点: 1. 在市场上的卖家帐户，点击您的帐户的图标→ **设置** 在左边的菜单中，选择 **Api和模块** →标签 **空气污染指数通知书**. 1. 找到你需要的通知，点击旁边的三个点，然后选择 **编辑**. 1. 更改所需信息。 1. 点击 **插头**. {% endcut %} {% cut "拔掉插头" %} 您可以禁用发送通知而不删除它们。 要做到这一点: 1. 在市场上的卖家帐户，点击您的帐户的图标→ **设置** 在左边的菜单中，选择 **Api和模块** →标签 **空气污染指数通知书**. 1. 找到你需要的通知，点击旁边的三个点，然后选择 **拔掉插头**. {% endcut %} {% cut "插头" %} 使禁用的通知再次工作: 1. 在市场上的卖家帐户，点击您的帐户的图标→ **设置** 在左边的菜单中，选择 **Api和模块** →标签 **空气污染指数通知书**. 1. 找到你需要的通知，点击旁边的三个点，然后选择 **插头**. 1. 如果Yandex禁用了通知。市场，您将收到请求。 [POST 通知书](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/reference/sendNotification.md) 哪里会有一个验证通知在正文中与类型 `PING`. 用代码返回响应 `200` 和10秒内的通知处理的信息。 {% endcut %} {% cut "重复设置" %} 要避免从头开始为商店创建通知，请复制已为其他商店创建的设置: 1. 在市场上的卖家帐户，点击您的帐户的图标→ **设置** 在左边的菜单中，选择 **Api和模块** →标签 **空气污染指数通知书**. 1. 找到你需要的通知，点击旁边的三个点，然后选择 **重复设置**. 1. 指定所需的存储。 1. 点击 **复制**. {% endcut %} {% cut "移走" %} 删除通知: 1. 在市场上的卖家帐户，点击您的帐户的图标→ **设置** 在左边的菜单中，选择 **Api和模块** →标签 **空气污染指数通知书**. 1. 找到你需要的通知，点击旁边的三个点，然后选择 **移走**. 1. 确认删除。 {% endcut %} [*notification-type]: Yandex的事件。市场发送通知:测试订单也将发送通知。 [*ip-range-5-45-207]: 地址由5.45.207.0至5.45.207.127 [*ip-range-141-8-142]: 地址从141.8.142.0到141.8.142.127 [*ip-range-5-255-253]: 地址由5.255.253.0至5.255.253.127