API通知与 push-api — 与Yandex合作的旧计划。 市场。

如何使用通知

您可以启用API通知和Yandex。Market会向您发送请求。 POST 通知书 有关[活动]的资料(*notification-type) 每次它发生。

这是一个可选的集成,您不必启用通知。 但是,在他们的帮助下,您将能够快速响应订单的更改,非购买和退款,以及取消订单的请求。

市场仅与使用SSL证书通过HTTPS操作的商店交换数据。 它必须由官方证书颁发机构签名,自签名证书将不起作用。 有关证书颁发机构的信息可以在互联网上找到。

根据IP地址范围检查每个请求。

集成的安全性取决于它。 — 这样,您将确保请求来自Yandex。市场。

市场使用的IP地址范围:

  • 5.45.207.0/25
  • 141.8.142.0/25
  • 5.255.253.0/25

启用集成

启用集成的屏幕截图

接收Yandex的通知。街市:

  1. 在市场上的卖家帐户,点击您的帐户的图标→ 设置 在左边的菜单中,选择 Api和模块 →标签 空气污染指数通知书.

  2. 点击按钮 启用通知.

  3. 指定通知名称 — 您只需要它来搜索列表中的通知。

  4. 选择您是为商家资料还是商店设置通知:


    通知即将到来

    设置通知所需的角色

    角色是什么?

    办公室

    适用于所有橱柜店

    内阁所有者或内阁经理

    商店

    对于特定的商店

    内容管理器以外的任何角色

  5. 选择要接收的通知类型:

    通知书 为内阁而来 它是为商店而来的
    创建订单 ✔️ ✔️
    更改订单 ✔️ ✔️
    更改订单状态 ✔️ ✔️
    取消订单 ✔️ ✔️
    创建订单取消请求 ✔️ ✔️
    退款或不购买 ✔️ ✔️
    更改退款或非购买状态 ✔️ ✔️
    新检讨 ✔️
    新评论 ✔️
    与买家的新聊天 ✔️
    聊天中的新消息 ✔️
    争端的开始 ✔️
    结束争议 ✔️

    ⚠️ 如果为商家配置文件配置了与订单相关的通知,则还会通过以下方式发送 FBY-命令。

  6. 输入yandex的链接。市场将发送通知。 完整地指定它,包括HTTPS协议。

  7. 点击按钮 插头. 创建的通知将立即出现在仪表板中,但它们将开始到达。 2分钟内.

检查集成

要检查集成的功能,yandex的。市场将发送请求 POST 通知书 哪里会有一个验证通知在正文中与类型 PING.

请求体示例
{
  "notificationType": "PING",
  "time": "2025-01-16T10:09:49.759084017Z"
}

用代码返回响应 200 及10秒内的通知处理的信息。 如果传输另一个代码,不正确或数据不足,则不会启用集成。 可能的错误

响应体的示例
{
  "version": "1.0.0",
  "name": "name",
  "time": "2025-01-16T10:09:49.759084017Z"
}

对请求的响应

响应时间为10秒。

  • 如果请求正确,则返回代码 200 用通知处理的信息。 响应体

  • 如果市场发送了错误的通知,请返回代码。 400 与错误的描述。 市场将分析此类响应并完善API。 响应体

  • 如果您有技术错误,请返回代码。 500. 响应体

有关请求和响应的详细信息,包括错误,可以在市场上的卖方帐户中查看。 — 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块 →标签 通知日志. 阅读更多关于这一节 请求日志.

可能的错误

商店的API没有响应

如果存储不满足十秒超时或请求 POST 通知书 返回一个错误,除了 400、市场:

  • 它停止发送其他通知,直到它收到对有问题的请求的合适响应。

  • 重复有问题的查询:

    1. 第一个小时的每一分钟。
    2. 第一天每15分钟一次。
    3. 然后每小时一次。

如果商店的API在发送第一个通知后的14天内不可用,则商店将被禁用。 从整合,但继续发布和销售产品。 燕基科斯.市场将取消所有在断开连接之前无法发送的通知,并且不会发送新的通知。

要继续接收通知,请再次连接它们。 有关如何执行此操作的详细信息,请参阅 通知管理.

通知管理

更改通知后

仪表板中的信息将立即更新,但通知将开始到来或关闭。 2分钟内.

连接集成的屏幕截图

要改变

您可以编辑通知的名称和类型,以及发送通知的链接。 要做到这一点:

  1. 在市场上的卖家帐户,点击您的帐户的图标→ 设置 在左边的菜单中,选择 Api和模块 →标签 空气污染指数通知书.

  2. 找到你需要的通知,点击旁边的三个点,然后选择 编辑.

  3. 更改所需信息。

  4. 点击 插头.

拔掉插头

您可以禁用发送通知而不删除它们。 要做到这一点:

  1. 在市场上的卖家帐户,点击您的帐户的图标→ 设置 在左边的菜单中,选择 Api和模块 →标签 空气污染指数通知书.

  2. 找到你需要的通知,点击旁边的三个点,然后选择 拔掉插头.

插头

要使禁用的通知再次工作:

  1. 在市场上的卖家帐户,点击您的帐户的图标→ 设置 在左边的菜单中,选择 Api和模块 →标签 空气污染指数通知书.

  2. 找到你需要的通知,点击旁边的三个点,然后选择 插头.

  3. 如果Yandex禁用了通知。市场,您将收到请求。 POST 通知书 哪里会有一个验证通知在正文中与类型 PING. 用代码返回响应 200 和10秒内的通知处理的信息。

重复设置

要避免从头开始为商店创建通知,请复制已为其他商店创建的设置:

  1. 在市场上的卖家帐户,点击您的帐户的图标→ 设置 在左边的菜单中,选择 Api和模块 →标签 空气污染指数通知书.

  2. 找到你需要的通知,点击旁边的三个点,然后选择 重复设置.

  3. 指定所需的存储。

  4. 点击 复制.

移走

删除通知:

  1. 在市场上的卖家帐户,点击您的帐户的图标→ 设置 在左边的菜单中,选择 Api和模块 →标签 空气污染指数通知书.

  2. 找到你需要的通知,点击旁边的三个点,然后选择 移走.

  3. 确认删除。

Yandex的事件。市场发送通知:

  • 创建新订单;
  • 更改订单;
  • 更改订单状态;
  • 创建与客户的新聊天;
  • 添加新的聊天消息;
  • 争端的开始;
  • 结束争议;
  • 创建新产品评论;
  • 创建新的评论评论;
  • 创建订单取消请求;
  • 取消订单;
  • 创建新的非购买或退款;
  • 更改非购买或退款状态。
测试订单也将发送通知。

地址由5.45.207.0至5.45.207.127

地址从141.8.142.0到141.8.142.127

地址由5.255.253.0至5.255.253.127