# @gyldendalas/gyldendal-divine-api 中文文档

规范地址：https://npmcn.com/package/%40gyldendalas/gyldendal-divine-api/

版本：2\.4\.0
npm 元数据更新时间：2026-11-04T13:19:08.130Z
中文译文更新时间：2026-11-17T06:12:22.463Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gyldendalas/gyldendal-divine-api
原文对照：https://npmcn.com/package/%40gyldendalas/gyldendal-divine-api/?lang=original
源码仓库：https://github.com/gyldendalsolutions/gyldendal-divine-api

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

- 包体积（解压后）：371 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2025-02-17T14:23:29.309Z
- 最新版本发布：2026-11-04T13:19:07.738Z
- 近 30 天下载量：5818（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：68（近 12 个月 41 个）

## 中文简介

暂无中文简介

## 安装

```sh
npm install @gyldendalas/gyldendal-divine-api
```

也可以使用：`pnpm add @gyldendalas/gyldendal-divine-api`、`yarn add @gyldendalas/gyldendal-divine-api`、`bun add @gyldendalas/gyldendal-divine-api`

## README

# Gyldendal 神灵API

Gyldendal的GU-D部门的API客户端集.

## 环境

每个服务都从 `environment` 传到 构造器( `installationpurpose` tYPO3装置,除非 `serviceUrl` 被明确给予.

| 环境 | 决定: |
| --- | --- |
| `production` | 生产服务 |
| `development`, (中文(简体) ), `testing` | 中转服务 |
| `local` | 本机运行的服务,见下表: |
| `test` | playwright 模拟服务器 `https://localhost:3010/services/<name>` |

### 当地服务

`local` 是在开发的同时自己管理服务。 服务就位 在一个预留的4110 -4180块, 相隔10个, 所以一个服务 和它自己的 依赖关系(DynamoDB local, 其管理UI) 在一起, 没有任何碰撞 前端( 3000- 3002 nuxt, 3010 模拟服务器), macOS AirPlay 接收器(5000,700),容器默认服务本身使用 8000,8001,5432,8983)或麻黄(49152和上)范围. 每个服务 docker-compose仅发布于127.0.0.1上的端口,下面的URL表示: 127.0.0.1 而不是当地东道主,原因如下:当地东道主决心 首先在 macOS 上, 仅一个 IPv4 的映射没有在听 。 这个 `test` 环境保存本地主机, 因为 Playwright 模拟服务器的证书 为这个名称而发布.

| 服务 | 当地 URL | 端口来源 |
| --- | --- | --- |
| 用户设置 | `http://127.0.0.1:4110` | `user_settings_service` docker-company (DynamoDB 4111, admin 4112) (英语) |
| 突出显示 | `http://127.0.0.1:4120` | `systime_highlight_server` docker-compose-development (DynamoDB 4121, admin 4122, pgvector 4123) (美国英语) |
| pdf 生成器 | `http://127.0.0.1:4130` | `pdf_generation_service` 嵌入式编组开发 |
| 写入任务 | `http://127.0.0.1:4140` | `stepwise_task_server` docker-compose-development (DynamoDB 4141, admin 4142) (英语) |
| solr 代理服务器 | `http://127.0.0.1:4150` | `solr-proxy` docker-compose-development (soler本身 4151) (英语) |
| 标记 | `http://127.0.0.1:4160` | 此处保留; repo 尚未开发 |
| AI 机器人 | `http://127.0.0.1:4170` | 此处保留; `ai-bot-service` 默认值为 3100 |
| 饼干同意记录 | `http://127.0.0.1:4180` | 此处保留; `cookie_consent_service` 默认值为 1337 |
| 花粉 | `http://127.0.0.1:3200` | `systime-appear-polly` docker-compose-development;其集装箱端口3000由nuxt dev取出. 合成需要AWS证书,集装箱的CORS预飞目前拒绝 `Authorization` sDK 发送的页眉 |
| 考试(Gale CMS) | `https://galecms.test.tibalo.dk/api` | 没有本地 Gale, 共享测试实例 |

盖尔也有一个QA安装,这不是它自己的环境—— `quiz` 唯一的服务是有一个。 它导出为 `GALE_QA_URL` 财务报告和审定财务报表 应用为覆盖, 因此 URL 保留在这个软件包中 :

```ts
import { GALE_QA_URL } from '@gyldendalas/gyldendal-divine-api';

environmentOverrides: { quiz: GALE_QA_URL }
```

TYPO3通过网站查询 `site.sso.sso_overrides.galeQaEndpointEnabled`。 。 。 . 这是一种测试安排,所以由打电话者决定是否遵守:a 生产中也应用了构造器重置,不同于环境 见下文.

### 管理当地和托管服务

`environment` 选择一个环境为一切, 这很少是什么 本地开发想要: 通常有一个服务运行在您的机器和 休息应该来自中转. `environmentOverrides` 说哪个环境 单个服务在其中解决,按下服务名称键 `src/services/service_urls.ts`数字 :

```ts
const divine = {
  environment,          // the installationpurpose, as always
  myAccountId,
  environmentOverrides: { highlight: 'local' }
};

new HighlightService(divine);   // http://127.0.0.1:4120
new TaggingService(divine);     // https://staging-tagging.services.systime.dk
```

在应用程序启动时将对象建构,并将同一对象交给 每一个服务, 所以混合生活在一个地方.

注意它命名为 _环境_,而不是一个 URL。 超常读取 因此,一个可以移动的服务,包括当地港口 服务您所超越的 —— 仍然为您在下一个版本上移动 软件包。 这就是保持 URL在这里的全部要点, 一个呼叫者 谁写一个URL 已经退出了.

对于终点,表格无法知道——非标准服务 端口、隧道、同事的分支部署—— 超接可能是 URL 相反:

```ts
environmentOverrides: { highlight: 'http://127.0.0.1:9999' }
```

`serviceUrl` 仍然工作, 仍然比其他一切。 这是正确的 此软件包完全不知道服务的工具, 而错误的软件包 当地的发展,它默默地选择你 不再做任何未来的改变 那个服务地址.

### 在不碰应用程序的情况下覆盖

超接也可以来自机器 而不是代码,它 把它完全置入仓库 每一次服务,无论是:

-   环境变量 `DIVINE_ENV_<SERVICE>` —— 说 `DIVINE_ENV_HIGHLIGHT`, (中文(简体) ), `DIVINE_ENV_PDF_GENERATOR`,等等;
-   `globalThis.__divineEnvironmentOverrides`,由一个仅由 Nuxt 插件或 插入的脚本,这是其中唯一一个到达 浏览器捆绑 .

两者都采用与 `environmentOverrides`。一个 `environmentOverrides` 代码中的条目击败他们,环境变量击败他们 `globalThis`, (中文(简体) ), 也没有读过 `environment` 实值 `production`: 配置 离开乐队 是一个危险在那里 不管它碰巧说.

### 每一次都报告过

一种适用的取消——从四个机制中的任何一种, `serviceUrl` 包括——在第一次解决时写出这样的一行:

```
[gyldendal-divine-api] highlight is overridden: resolved to http://127.0.0.1:4120 instead of its "development" endpoint (source: environmentOverrides).
```

失败模式 这一切都是一个被遗忘的覆盖: 3周前和3周后出口的变量 忘记了 所以,通知不是沉默 在生产,它很重要 大部分,它命名源,因为"高光在127.0.0.1上"是一个 单凭自己就拼出谜题,一旦说出是谁的把手就不再是一个.

每个程序都写过一次 而不是每次请求, 因为每个电话上的警告都是没人读的警告 过 `onOverride` 改为 送别的地方去 `console.warn`,此软件包将写给 无他处:

```ts
new HighlightService({ ...divine, onOverride: ({ message }) => logger.warn(message) });
```

## 常见问题

### 如何安装 @gyldendalas/gyldendal-divine-api？

在项目目录运行 npm install @gyldendalas/gyldendal-divine-api，或使用 pnpm add / yarn add / bun add。

### @gyldendalas/gyldendal-divine-api 支持 TypeScript 吗？

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

### @gyldendalas/gyldendal-divine-api 支持 ESM 还是 CommonJS？

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

### @gyldendalas/gyldendal-divine-api 可以商用吗？

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

### @gyldendalas/gyldendal-divine-api 的下载量有多少？

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

### @gyldendalas/gyldendal-divine-api 还在维护吗？

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

