# @epcc-sdk/sdks-cart-checkout-order 中文文档

规范地址：https://npmcn.com/package/%40epcc-sdk/sdks-cart-checkout-order/

版本：0\.8\.3
npm 元数据更新时间：2026-11-03T15:53:06.923Z
中文译文更新时间：2026-11-14T07:26:46.213Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40epcc-sdk/sdks-cart-checkout-order
原文对照：https://npmcn.com/package/%40epcc-sdk/sdks-cart-checkout-order/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：6.8 MB，103 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：zod ^4\.0\.0，@modelcontextprotocol/server ^2
- 首次发布：2025-03-13T19:08:30.137Z
- 最新版本发布：2026-11-03T15:53:06.759Z
- 近 30 天下载量：2129（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 15 个）

## 中文简介

一个用于"弹性路径"手推车的TypeScript客户端,退出并订购API. 函数,类型和Zod schemas由API的OpenAPI spec生成.

## 安装

```sh
npm install @epcc-sdk/sdks-cart-checkout-order
```

也可以使用：`pnpm add @epcc-sdk/sdks-cart-checkout-order`、`yarn add @epcc-sdk/sdks-cart-checkout-order`、`bun add @epcc-sdk/sdks-cart-checkout-order`

## README

# @ epcc- sdk/ sdks- cart- checkout- 顺序

一个用于"弹性路径"手推车的TypeScript客户端,退出并订购API. 函数,类型和Zod schemas由API的OpenAPI spec生成.

## 安装

```bash
npm install @epcc-sdk/sdks-cart-checkout-order
```

## 快开始

```ts
import {
  createCartCheckoutOrderClient,
  getCarts,
} from "@epcc-sdk/sdks-cart-checkout-order"

const client = createCartCheckoutOrderClient({
  baseUrl: "https://euwest.api.elasticpath.com",
  clientId: process.env.EPCC_CLIENT_ID!,
  clientSecret: process.env.EPCC_CLIENT_SECRET!,
})

const { data, error } = await getCarts({ client })
```

客户端获得访问符并添加到每个请求中. 在信使到期前,它会得到一个新的信使. 在401回信后,它得到一个新的信使并再次发出请求. 经过408或429回應后,或一些服务器和网络出错后,它会再等一等再发送请求.

将客户端传递到每个操作中. 该套件还输出 a `client` 没有证书。 如果您不使用操作 `{ client }`,它使用该客户端,API返回一个401响应.

失败的请求不会丢出 。 操作返回错误 `error`。要启动操作,请添加 `config: { throwOnError: true }` 到工厂的选择.

## 基础 URL

设定 `baseUrl` 到您所在区域的 API 主机, 没有路径 。 每个操作都增加了自己的路径.

## 全权证书

| 选项 | 赠款类型 |
| --- | --- |
| `clientId` 财务报告和审定财务报表 `clientSecret` | 客户证书. 只用在服务器上,因为它包含一个秘密. |
| `clientId` | 隐相相. 你可以在浏览器中使用. |
| `token` | 一个你得到自己的标志。 客户端无法取而代之,所以401回复是最终的. |
| `provider` | 属于你的 `TokenProvider` 函数. |
| `source` | A 类 `TokenSource` 用于保存,例如当用户签名退出时清除符号. |

这些选项改变默认行为 :

| 选项 | 它会做什么 |
| --- | --- |
| `storage` | 委托人把信物放在那里 默认是 `memoryStorage`。 。 。 . `localStorageAdapter` 将符号保存在页面加载和浏览器标签上. |
| `leewaySeconds` | 到期前几秒客户端获得新符. |
| `retry` | 备选方案 `createRetryFetch`设置它 `false` 以停止复试. |
| `fetch` | 这个 `fetch` 函数,客户端用于所有请求,包括符号请求. |
| `config` | 例如客户端配置 `headers`它超越了工厂设定的值. |

## 让客户自己来

包裹出口出工厂使用的零件. 需要自有或自有信号源时使用 `fetch`。 。 。 .

```ts
import {
  clientCredentialsProvider,
  createAuthCallback,
  createAuthenticatedFetch,
  createClient,
  createConfig,
  createRetryFetch,
  createTokenSource,
} from "@epcc-sdk/sdks-cart-checkout-order"

const source = createTokenSource(
  clientCredentialsProvider({
    baseUrl: "https://euwest.api.elasticpath.com",
    clientId: process.env.EPCC_CLIENT_ID!,
    clientSecret: process.env.EPCC_CLIENT_SECRET!,
  }),
)

const client = createClient(
  createConfig({
    baseUrl: "https://euwest.api.elasticpath.com",
    auth: createAuthCallback(source),
    fetch: createRetryFetch({ fetch: createAuthenticatedFetch(source) }),
  }),
)
```

1.  将两个包裹都从同一处制成 `source`。 。 。 . `createAuthenticatedFetch` 仅替换来自其来源的符号.
2.  打开 `createAuthenticatedFetch` 内部 `createRetryFetch`。在另一个顺序中,每次重试都会再次发送过期的符号.

不要用请求截取器添加符号 。 截取器无法看到响应,因此在401响应后无法得到新的信号.

## Zod 计划

这个 `./zod` 导出对每次请求和响应都有Zod计划. `zod` 4是可选的对等依赖,因此主要出口不导入.

```ts
import { zGetCartsResponse } from "@epcc-sdk/sdks-cart-checkout-order/zod"

const result = zGetCartsResponse.safeParse(data)
```

Spec 给出的字段 `int64` 是一个 `number` 在各种种类和计谋中.

## MCP工具

这个 `./mcp` 导出每个操作都有一个模式上下文协议(MCP)工具,用于MCP SDK v2. 惠璶 `zod` (单位:千美元) `@modelcontextprotocol/server` 2只用于此导出.

```ts
import { McpServer } from "@modelcontextprotocol/server"
import { tools } from "@epcc-sdk/sdks-cart-checkout-order/mcp"

const server = new McpServer({ name: "cart-checkout-order", version: "1.0.0" })

for (const tool of tools({ client })) {
  server.registerTool(tool.name, tool.config, tool.handler)
}
```

-   每个工具都会向客户端发送它的请求,由您给出. 向每个请求发送一个信头,例如 `EP-Store-Id`,设置在 `config.headers` 客户.
-   对于一个工具,使用它的工厂。 工厂的名称是操作名称 `Tool` 添加,例如 `getCartsTool`。 。 。 .
-   工具的名称是 `cart_checkout_order_` 和操作名称,例如蛇案 `cart_checkout_order_get_carts`。 。 。 .
-   工具的参数在 `path`, (中文(简体) ), `query`, (中文(简体) ), `headers` 财务报告和审定财务报表 `body`编辑 `Authorization` 头来自客户端.
-   `tool.config._meta["com.elasticpath/operation"].risk` 实值 `read`, (中文(简体) ), `create`, (中文(简体) ), `update` 或者说 `delete`。工具说明来自它。 仅登记读取的工具,将工具保存在 `risk` 实值 `read`。 。 。 .
-   工具返回 API 错误为 `isError` 结果。 它不会扔出.

这些操作的风险与其HTTP方法的默认不同:

-   `anonymizeOrders` 实值 `update`,因为它以订单取代客户数据,不能被撤销.

## 常见问题

### @epcc-sdk/sdks-cart-checkout-order 是什么？

一个用于"弹性路径"手推车的TypeScript客户端,退出并订购API\. 函数,类型和Zod schemas由API的OpenAPI spec生成\.

### 如何安装 @epcc-sdk/sdks-cart-checkout-order？

在项目目录运行 npm install @epcc-sdk/sdks-cart-checkout-order，或使用 pnpm add / yarn add / bun add。

### @epcc-sdk/sdks-cart-checkout-order 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @epcc-sdk/sdks-cart-checkout-order 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @epcc-sdk/sdks-cart-checkout-order 可以商用吗？

@epcc-sdk/sdks-cart-checkout-order 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @epcc-sdk/sdks-cart-checkout-order 的下载量有多少？

根据 npm 官方下载统计，@epcc-sdk/sdks-cart-checkout-order 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,129 次，日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @epcc-sdk/sdks-cart-checkout-order 还在维护吗？

最新版本 0\.8\.3 发布于 2026/11/03（10 天前）；至今共发布 22 个版本，其中过去 12 个月发布了 15 个；首次发布于 2025/03/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。