@api-platform/admin

中文文档
4.0.9发布于 2026/02/27MITTypeScriptES Module构建来源已验证近 30 天下载 2.4万

Hydra-United API的自动管理接口.

中文使用文档
文档目录6 节
  1. 演示
  2. 安装
  3. 使用量
  4. 特征
  5. 文档
  6. 贷项

API 平台管理员

GitHub Actions npm version

API 平台管理器是自动创建美丽(Matrial Design)和全功能管理界面的工具 对于任何 API 支持 海德拉核心词汇表 或揭露 OpenAPI 文档, (中文(简体) ), 包括但不仅限于使用 aPI 平台框架。 。 。 .

Demo of API Platform Admin in action

生成的管理器是100%的独立单页应用程序,没有连接到服务器部分 到API的第一个范式.

API 平台管理员 剖析 Hydra 或 OpenAPI 文档, 然后使用 awers 反应admin 图书馆(和 反应),以曝光一个很好的,反应灵敏的管理界面(Create-Retriev-Update-Delete) 所有可用资源.

也可以通过使用React-admin组件甚至原始JavaScript/React代码来自定义所有屏幕.

演示

点击这里 用于在现场测试 API 平台管理员.

演示的源代码可用 在此寄存器中。 。 。 .

安装

yarn add @api-platform/admin

使用量

import React from 'react';
import ReactDOM from 'react-dom';
import { HydraAdmin, OpenApiAdmin } from '@api-platform/admin';

// To use Hydra:
const Admin = () => <HydraAdmin entrypoint="https://demo.api-platform.com" />; // Replace with your own API entrypoint
// To use OpenAPI (with a very simple REST data provider):
const Admin = () => <OpenApiAdmin
  docEntrypoint="https://demo.api-platform.com/docs.json" // Replace with your own OpenAPI documentation entrypoint
  entrypoint="https://demo.api-platform.com" // Replace with your own API entrypoint
/>;

ReactDOM.render(<Admin />, document.getElementById('root'));

或者说:

import React from 'react';
import ReactDOM from 'react-dom';
import {
  AdminGuesser,
  hydraDataProvider,
  hydraSchemaAnalyzer,
  openApiDataProvider,
  openApiSchemaAnalyzer
} from '@api-platform/admin';
import simpleRestProvider from 'ra-data-simple-rest';

// Use your custom data provider or resource schema analyzer
// Hydra:
const dataProvider = hydraDataProvider({ entrypoint: 'https://demo.api-platform.com' });
const schemaAnalyzer = hydraSchemaAnalyzer();
// OpenAPI:
const dataProvider = openApiDataProvider({
  // Use any data provider you like
  dataProvider: simpleRestProvider('https://demo.api-platform.com'),
  entrypoint: 'https://demo.api-platform.com',
  docEntrypoint: 'https://demo.api-platform.com/docs.json',
});
const schemaAnalyzer = openApiSchemaAnalyzer();

const Admin = () => (
  <AdminGuesser
    dataProvider={dataProvider}
    schemaAnalyzer={schemaAnalyzer}
  />
);

ReactDOM.render(<Admin />, document.getElementById('root'));

特征

  • 由于 Hydra 的超媒体特性或 OpenAPI 文档, 自动生成对 API 全部资源的管理界面
  • 生成“ 列表”、“ 创建”、“ 显示” 和“ 编辑” 屏幕以及删除按钮
  • 根据 API doc 生成合适的输入和字段(例如数字的 HTML 输入,布尔语的复选框,关系的选择框...)
  • 根据 Schema.org 类型生成合适的输入和字段(例如: http://schema.org/email(中文(简体) )
  • 处理关系
  • 支持页化
  • 支持过滤和排序
  • 根据 API 描述自动验证一个字段是否为强制客户端
  • 向 API 发送适当的 HTTP 请求, 并使用 Hydra 和 JSON- LD 格式解码
  • 很好的显示服务器侧出错( 如高级验证)
  • 支持实时更新 信使
  • 所有的东西 react-admin 提供的特性 也可以使用
  • 100%可定制

文档

API 平台管理员的文档可以浏览 官方网站(简体中文)。 。 。 .

还检查 React-admin 的文档 在他们的官方网站上。 。 。 .

贷项

创建于 凯文·邓格拉斯发起人: 莱-蒂勒斯.coop。 。 。 . 应请求提供商业支助.

版本与发布记录

@api-platform/admin 共发布 101 个版本,首次发布于 2017/09/15;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.0.9latest2026/02/278 个月前
4.0.82026/01/0610 个月前
4.0.72025/05/161.5 年前
4.0.62025/03/111.7 年前
4.0.52025/03/111.7 年前
4.0.42025/01/301.8 年前

关于 @api-platform/admin 的常见问题

@api-platform/admin 是什么?

Hydra-United API的自动管理接口.

如何安装 @api-platform/admin?

在项目目录运行 npm install @api-platform/admin,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(*)、react-dom(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@api-platform/admin 支持 TypeScript 吗?

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

@api-platform/admin 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@api-platform/admin 可以商用吗?

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

@api-platform/admin 的下载量有多少?

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

@api-platform/admin 还在维护吗?

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