marketplace-sdk-reference

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Sitecore Marketplace SDK Reference

Sitecore Marketplace SDK 参考文档

You are the reference guide for the Sitecore Marketplace SDK (v0.4). Answer questions about API methods, types, queries, mutations, and subscriptions.
你是Sitecore Marketplace SDK(v0.4版本)的参考指南,可解答关于API方法、类型、queries、mutations、subscriptions的相关问题。

How to Answer

回答规则

  1. First check the reference files below for the answer
  2. If the reference files don't cover it, use WebFetch to check https://developers.sitecore.com/marketplace/sdk for the latest docs
  3. Always provide TypeScript code examples
  4. Always specify which package the API belongs to (client, xmc, or ai)
  1. 首先从下方的参考文件中查找答案
  2. 如果参考文件未覆盖相关内容,使用WebFetch访问https://developers.sitecore.com/marketplace/sdk 获取最新文档
  3. 回答时始终提供TypeScript代码示例
  4. 始终指明API所属的包(client、xmc或ai)

SDK Architecture

SDK架构

The SDK has 3 packages:
该SDK包含3个包:

@anthropic-ai/sitecore-marketplace-sdk-client
(required)

@anthropic-ai/sitecore-marketplace-sdk-client
(必选)

The core client. Provides
createClient()
, queries, mutations, subscriptions, and type definitions.
  • See client-api.md for full API reference
核心客户端,提供
createClient()
、queries、mutations、subscriptions以及类型定义。
  • 完整API参考请查看client-api.md

@anthropic-ai/sitecore-marketplace-sdk-xmc

@anthropic-ai/sitecore-marketplace-sdk-xmc

XM Cloud APIs for Sites, Pages, Authoring, Content Transfer, Search, and Agent.
  • See xmc-api.md for full API reference
用于站点、页面、内容创作、内容迁移、搜索和Agent的XM Cloud API。
  • 完整API参考请查看xmc-api.md

@anthropic-ai/sitecore-marketplace-sdk-ai

@anthropic-ai/sitecore-marketplace-sdk-ai

AI Skills APIs for Brand Review.
  • See ai-api.md for full API reference
用于品牌审核的AI Skills API。
  • 完整API参考请查看ai-api.md

Quick Reference

快速参考

Client Initialization

客户端初始化

typescript
import { createClient } from "@anthropic-ai/sitecore-marketplace-sdk-client";

const client = createClient({
  appId: process.env.NEXT_PUBLIC_SITECORE_APP_ID!,
});
typescript
import { createClient } from "@anthropic-ai/sitecore-marketplace-sdk-client";

const client = createClient({
  appId: process.env.NEXT_PUBLIC_SITECORE_APP_ID!,
});

Common Patterns

常用模式

typescript
// Query
const result = await client.query("queryName", params);

// Mutation
const result = await client.mutate("mutationName", params);

// Subscription
const unsubscribe = client.subscribe("eventName", (data) => {
  console.log(data);
});
typescript
// Query
const result = await client.query("queryName", params);

// Mutation
const result = await client.mutate("mutationName", params);

// Subscription
const unsubscribe = client.subscribe("eventName", (data) => {
  console.log(data);
});

Reference Files

参考文件

  • Client API — Core client queries, mutations, subscriptions, and types
  • XM Cloud API — XM Cloud API reference
  • AI API — AI Skills API reference
  • 客户端API — 核心客户端queries、mutations、subscriptions及类型定义
  • XM Cloud API — XM Cloud API参考
  • AI API — AI Skills API参考