@haneinfo/m2m-api-key

中文文档
8.1.38发布于 2026/11/17UNLICENSEDTypeScriptCommonJS近 30 天下载 6597
中文使用文档

机器对机器 API 密钥

范围目录

可授予目录来自挂载的REST @Scopes() 申报和申请 M2M_SCOPE_SOURCES (单位:千美元)ScopeSource[]) (中文(简体) ). 具体范围的使用 <resource>:<action>,在 最后一个结肠每个资源部分和行动必须只包含 [a-z0-9_-]时使用 每个段至少有一个字符。 譬如说, users:read, (中文(简体) ), haneinfo-reports:definition:read 财务报告和审定财务报表 haneinfo-reports:reports:data:read 声明时有效。 空片段, 白空间, 大写字符和嵌入式通配符被拒绝。 动作不限于读取/写入.

必须宣布新的赠款的具体范围, * (现有全球赠款),或 <resource>:* 用于至少有一个混凝土目录条目的资源。 通配符声明 单靠自己并不能建立资源。 资源匹配精确 : haneinfo-reports:definition:* 匹配 haneinfo-reports:definition:read,则 haneinfo-reports:* 没有。 后者 除非有具体的资源范围,否则无法发布 haneinfo-reports 已经宣布.

list() 返回所排序的具体范围; describe() 财务报告和审定财务报表 groupOf() 使用整个资源 应用程序 M2M_SCOPE_GROUPS 显示分组。 按键创建验证所有赠款; 更新验证 只有新增加的赠款,通过无关的编辑保留现有的遗留范围。 范围保障 编辑 SCOPE_MATCHER mCP 代理匹配插件- api 时使用的能力 matchScope。 。 。 .

见 代理指南 用于App接线和校验.

认证观察

成功的 API 密钥认证记录 lastUsedAt 一个同步。 使用一个有条件的数据库更新,将每个键的写入各个进程。 默认间隔为 60 秒; 设定 M2M_API_KEY_LAST_USED_INTERVAL_SECONDS 改为从 0 到 86400 的整数( 0 禁用节奏) 。 无效或缺失的值使用60秒 。 时间戳可以以所配置的间隔来拖慢最新的成功认证,再加上同步数据库延迟;写入失败会被记录下来,并在后一请求下进行再试. 这个时间戳是可观察的,并不决定认证或授权.

版本与发布记录

@haneinfo/m2m-api-key 共发布 42 个版本,首次发布于 2026/10/02;过去 12 个月发布了 42 个版本。

版本发布日期距今
8.1.38latest2026/11/17今天
8.1.372026/11/161 天前
8.1.362026/11/0412 天前
8.1.352026/11/0214 天前
8.1.342026/11/0115 天前
8.1.332026/10/3017 天前

关于 @haneinfo/m2m-api-key 的常见问题

如何安装 @haneinfo/m2m-api-key?

在项目目录运行 npm install @haneinfo/m2m-api-key,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^4.4.0)、@nestjs/core(^11.0.0 || ^12.0.0)、@nestjs/common(^11.0.0 || ^12.0.0)、@prisma/client(^6.19.0 || ^7.10.1)、@haneinfo/common(^0.6.1 || ^0.7.0)、@haneinfo/plugin-host-nest(^2.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@haneinfo/m2m-api-key 支持 TypeScript 吗?

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

@haneinfo/m2m-api-key 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@haneinfo/m2m-api-key 可以商用吗?

@haneinfo/m2m-api-key 使用 UNLICENSED 许可。作者声明为 UNLICENSED,即不授予公开使用许可(与公共领域的 Unlicense 不同)。使用前需获得作者授权。以上为概括,不构成法律意见,请以许可原文为准。

@haneinfo/m2m-api-key 的下载量有多少?

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

@haneinfo/m2m-api-key 还在维护吗?

最新版本 8.1.38 发布于 2026/11/17(今天);至今共发布 42 个版本,其中过去 12 个月发布了 42 个;首次发布于 2026/10/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。