开始使用Catalog Service

启用Catalog Service后,您可以访问该服务,并使用它从Adobe Commerce实例中检索目录数据,如产品和类别信息。 该服务作为GraphQL API提供,您可以从Commerce管理员或从支持GraphQL查询的任何前端应用程序访问该服务。

NOTE
对于使用Adobe Commerce Optimizer或Adobe Commerce Optimizer连接器的Commerce解决方案,请使用促销服务GraphQL API,而不是目录服务GraphQL API。

访问服务

Catalog Service可用作GraphQL API,您可以从Commerce管理员或任何支持GraphQL查询的前端应用程序访问它。 该服务在SaaS和PaaS环境中均可用。

[PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

环境
端点
正在测试
https://catalog-service-sandbox.adobe.io/graphql
生产
https://catalog-service.adobe.io/graphql

[SaaS]{class="badge positive" title="仅适用于Adobe Commerce as a Cloud Service和Adobe Commerce Optimizer项目(Adobe管理的SaaS基础架构)。"}

环境
端点
测试
https://na1-sandbox.api.commerce.adobe.com/{{tenant-id}}/graphql
生产(尚不可用)
https://na1.api.commerce.adobe.com/{{tenant-id}}/graphql

SaaS端点的​URL结构

https://<region>-<environment>.api.commerce.adobe.com/<tenantId>/graphql
  • <region>是部署实例的云区域。
  • <environment>是环境类型,如sandbox。 如果环境是生产环境,则忽略此值。
  • <tenantId>是Adobe Experience Cloud中您组织的特定实例的唯一标识符。

有关使用目录服务GraphQL API的详细信息,请参阅​ Adobe Commerce开发人员 ​文档中的Adobe Commerce目录服务指南

与Headless店面或第三方服务集成

要与Headless店面集成,您必须更新店面配置以启用店面和Catalog Service之间的通信以检索产品和类别数据。

如果您在Edge Delivery Services上使用Adobe Commerce店面,请将目录服务端点添加到店面配置。 有关详细信息,请参阅Edge Delivery Services文档

有关其他集成,请参阅项目设置文档,了解有关如何配置服务和后端数据源之间的集成的详细信息。

防火墙配置

要允许Catalog Service通过防火墙,请将commerce.adobe.io添加到允许列表。

目录服务和API网格

适用于Adobe Developer App Builder🔗的API Mesh使开发人员能够使用Adobe IO将专用或第三方API以及其他接口与Adobe产品集成。

有关安装和配置详细信息,请参阅Catalog Service 和API Mesh主题。

监控数据导出并排除其故障

Commerce管理员提供了用于监控从Commerce导出到所连接服务的数据并对其进行疑难解答的工具:

  • 数据管理仪表板 — 监视Catalog Service与Adobe Commerce实例之间的数据同步。 功能板显示整体同步状态并列出所有已同步的产品。

  • 数据馈送同步状态页面 — 跟踪所有数据馈送的导出状态,以确保数据一致性。 此页面会提醒您在导出过程中发生的问题,以便您能够快速解决这些问题。 “成功”状态表示数据已导出,当数据同步过程完成时,可在连接的Commerce服务中使用。

NOTE
如果“数据馈送同步状态”页面在Commerce on Cloud或本地部署的Commerce Admin中不可用,请按照扩展安装说明启用它。
recommendation-more-help
commerce-help-catalog-service