文档 / API

当前开放的是受控 API,不是裸接口市场。

ZhenMeta 当前只公开最小可用 API 面。接口必须服从作用域密钥、权益校验、审计和统一平台边界,而不是让业务前台自己长出第二套开发者平台。

开放接口面

当前对外只公开最小、受控、可解释的接口面。

当前开放接口

GET /api/zhenmeta/intel

用于读取机器人行业情报信号,不暴露需求提交、复核或工作区写入主模型。

鉴权方式

Authorization: Bearer <作用域密钥>

密钥状态、权限范围和权益会在服务端同时校验,不接受匿名公开调用。

默认速率限制

180 次请求 / 15 分钟

超过限制会返回 429,并附带速率限制头部。

接入路径

接口开放不等于另起一套开发者平台。

在 zhen-platform-console 获取作用域密钥,不在业务前台生成或管理。

01

调用公开 intel 读取接口,获取当前行业情报。

02

服务端同时校验权限范围、组织、工作区与权益。

03

订单、权益、下载与后续升级继续统一回到平台工作台。

04

当前公开权限范围

zhenmeta.intel.read
zhenmeta.demand.write
zhenmeta.provider.write
zhenmeta.review.read
zhenmeta.audit.read
zhenmeta.webhook.manage

当前返回结构

signals:当前公开的行业情报列表
access.organizationId:当前组织 ID
access.workspaceId:当前工作区 ID
access.scopes:已授予权限范围集合
access.intelEntitled:是否具备当前情报权益
access.entitlementFeatures:当前激活权益功能列表

固定边界

固定边界

需求提交、订单、权益、工作区和密钥生命周期不在业务前台自建主模型。
当前公开 API 只是前台接入位,正式经营解释统一由 zhen-platform-core 承担。
业务前端不直接调用 zhen-brain-core,执行主链保持为平台准入后再进入 brain。

工作台

开发者后续动作统一进入 zhen-platform-console

登录后继续处理

查看密钥、订单、权益、下载与后续升级,不在业务前台分散解释,而统一进入 zhen-platform-console。

登录后可处理

统一工作台

公开页面负责说明、收集信息和展示结果。

订单、下载、后续协作和升级等动作,会在登录后集中处理。

订单与进度

购买结果、交付状态和后续进度统一在登录后查看。

查看订单进度

已购权益

报告解锁、订阅和会员状态统一在这里继续确认。

查看已购权益

后续协作

需要持续跟进、补件或跨团队协作时,在这里继续处理。

进入后续协作

下载与交付

已获得的资料、模板和下载交付会集中在这里查看。

查看下载交付