# @habx/apollo-multi-endpoint-link 中文文档

规范地址：https://npmcn.com/package/%40habx/apollo-multi-endpoint-link/

版本：2\.9\.0
npm 元数据更新时间：2022-11-14T08:54:34.121Z
中文译文更新时间：2026-11-17T05:28:33.600Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40habx/apollo-multi-endpoint-link
原文对照：https://npmcn.com/package/%40habx/apollo-multi-endpoint-link/?lang=original
项目主页：https://github.com/habx/apollo-multi-endpoint-link#readme
源码仓库：https://github.com/habx/apollo-multi-endpoint-link

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

- 包体积（解压后）：29.3 kB，20 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@apollo/client ^3\.7\.1
- 首次发布：2020-03-05T11:28:13.001Z
- 最新版本发布：2022-11-14T08:54:34.027Z
- 近 30 天下载量：57722（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 0 个）

## 中文简介

添加 api 指令从多端获取数据的阿波罗链接

## 安装

```sh
npm install @habx/apollo-multi-endpoint-link
```

也可以使用：`pnpm add @habx/apollo-multi-endpoint-link`、`yarn add @habx/apollo-multi-endpoint-link`、`bun add @habx/apollo-multi-endpoint-link`

## README

## 添加 api 指令从多端获取数据的阿波罗链接

![](https://res.cloudinary.com/habx/image/upload/v1597742839/blog/tech/apollo-multi-link.jpg)

[![CircleCI](https://img.shields.io/circleci/build/github/habx/apollo-multi-endpoint-link)](https://app.circleci.com/pipelines/github/habx/apollo-multi-endpoint-link) [![Version](https://img.shields.io/npm/v/@habx/apollo-multi-endpoint-link)](https://www.npmjs.com/package/@habx/apollo-multi-endpoint-link) [![Size](https://img.shields.io/bundlephobia/min/@habx/apollo-multi-endpoint-link)](https://bundlephobia.com/result?p=@habx/apollo-multi-endpoint-link) [![License](https://img.shields.io/github/license/habx/apollo-multi-endpoint-link)](https://npmcn.com/LICENSE)

### 为什么?

我们写了 [文章](https://www.habx.com/tech/micro-graphql-schema) 如果你想知道更多细节,我们为什么和如何做这个链接.

### 安装

```bash
   npm i @habx/apollo-multi-endpoint-link
```

### 设置

```typescript
import { createHttpLink } from "apollo-link-http";

new ApolloClient({
 link: ApolloLink.from([
   new MultiAPILink({
       endpoints: {
           housings: 'https://housings.api',
           projects: 'https://projects.api',
           ...
       },
       createHttpLink: () => createHttpLink(),
     }),
 ])
})
```

NB: 自默认值以来 `httpSuffix` 实值 `/graphql`,上面的终点将被转换为 `https://housings.api/graphql` 财务报告和审定财务报表 `https://projects.api/graphql`。 。 。 . 如果您没有常见后缀, 您可以通过空字符串 `httpSuffix` 以避免这种转变.

注2:支持 [apollo-link-rest (英语)](https://github.com/apollographql/apollo-link-rest) 图书馆

##### API 密码

```typescript
new MultiAPILink(config, request);
```

###### 配置

| 参数 | 说明 | 默认 | 需求 |
| --- | --- | --- | --- |
| 结束点 | 终点词典 |  | 对 |
| 默认终点 | 默认终点 |  | 没有 |
| 创建 HttpLink 链接 | 要生成的函数 : [apollo-link-http (英语)](https://www.apollographql.com/docs/link/links/http/) |  | 对 |
| 创建WsLink | 生成 wsLink 这样的函数 [阿波罗-连线-ws](https://www.apollographql.com/docs/link/links/ws/) |  | 没有 |
| ws后缀 | 订阅查询的终点后缀 | /graphql/订阅 | 没有 |
| http后缀 | 为 http 查询添加了后缀 | 图像ql | 没有 |
| 获取康文本 | 调用要设置自定义的函数 [上下文](https://www.apollographql.com/docs/link/links/http/#context) 像头 |  | 没有 |
| 前缀 Typenames | 添加通过的名称参数 `@api` 对网络数据响应中包含的每个 类型名称进行指令 |  | 没有 |

### 查询

#### 使用静态 api 名称查询 :

```graphql
query projectList($params: Params) @api(name: projects) {
  projects(params: $params) {
    nodes {
      id
      name
    }
  }
}
```

```ts
const response = useQuery(myQuery);
```

#### 用动态 API 名称查询

```graphql
query projectList($params: Params) @api(contextKey: "apiName") {
  projects(params: $params) {
    nodes {
      id
      name
    }
  }
}
```

```ts
const response = useQuery(myQuery, { context: { apiName: "projects" } });
```

#### 设置自定义上下文

有时你可能需要设置自定义 [apollo 链接上下文](https://www.apollographql.com/docs/link/links/http/#context) 喜欢 `headers` 用于认证目的. 此链接允许它通过遵循来进行.

```typescript
new MultiAPILink({
    getContext: (endpoint) => {
      if (endpoint === 'yourendpoint-with-auth') {
        return ({
          headers: {
            'Authorization': 'xxxx',
          }
        })
      }
      return {}
    },
    ...
})
```

## 常见问题

### @habx/apollo-multi-endpoint-link 是什么？

添加 api 指令从多端获取数据的阿波罗链接

### 如何安装 @habx/apollo-multi-endpoint-link？

在项目目录运行 npm install @habx/apollo-multi-endpoint-link，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@apollo/client（^3\.7\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @habx/apollo-multi-endpoint-link 支持 TypeScript 吗？

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

### @habx/apollo-multi-endpoint-link 支持 ESM 还是 CommonJS？

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

### @habx/apollo-multi-endpoint-link 可以商用吗？

@habx/apollo-multi-endpoint-link 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @habx/apollo-multi-endpoint-link 的下载量有多少？

根据 npm 官方下载统计，@habx/apollo-multi-endpoint-link 在 2026/10/17 – 2026/11/15 这 30 天内被下载 57,722 次，日均约 1,924 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @habx/apollo-multi-endpoint-link 还在维护吗？

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

