控制平面资源地图
浏览真实 Den API 中的组织、配置、市场、连接器、Skill 和托管 Worker 资源族。
Den API 是 iPolloWork 的组织控制平面。它负责身份、组织成员、共享配置、访问授权、托管模型、连接器状态和托管 Worker。它不负责个人任意本地文件系统，也不是 Local Server API 的替代品。
每项资源都有生命周期、稳定 ID 与访问模型。账户身份、可复用配置、外部连接和运行时任务应保持为独立对象。
谁可以行动
`/v1/me`、`/v1/me/orgs` 和 `/v1/org` 建立当前组织上下文。
成员关系和委托访问与会话凭据分别表示。
什么可以被复用
具有生命周期、历史、插件关系与授权的可寻址配置。
具有独立解析与访问路由的可复用能力容器。
工作在哪运行或同步
账户、实例、目标、映射、发现与同步事件保持为独立对象。
具有独立运行时状态和活动记录的可选组织托管运行时资源。
每个集成都从身份开始
稳定的集成顺序：
- 认证并调用
GET /v1/me。 - 通过
GET /v1/me/orgs读取组织，并选择目标组织上下文。 - 使用有边界的列表路由与服务端过滤发现资源集合。
- 使用不可变资源 ID 写入最小资源变更。
- 重新读取资源、版本、解析视图、活动或同步事件。
UI 中的展示名称只是上下文，不是持久主键。应保存 API 返回的 ID。
- 01认证
按路由所需的方案建立调用方身份。
- 02定域
解析活动组织，并验证调用方能够看到目标集合。
- 03收敛
在获取记录前使用分页、类型、状态以及 connector 或 plugin 过滤。
- 04组合
一次创建、连接、授权、解析或归档一个资源族，然后重新读取。
资源族与实际路由组
| 资源族 | 关键路由 | 生命周期指引 |
|---|---|---|
| 身份与管理 | /v1/me、/v1/me/orgs、/v1/org、/v1/api-keys，以及 members、invitations、teams、roles | 先读取调用方与组织。API Key 与委托角色应视为安全敏感的管理资源。 |
| 模型提供商 | /v1/llm-provider-catalog、/v1/llm-providers | 选择目录能力、创建 provider 记录，再按策略连接或授权。 |
| 配置对象 | /v1/config-objects、版本、访问、插件、archive/delete/restore 路由 | 保留版本历史，并按运行时需要读取准确的 latest、version 或 resolved 端点。 |
| 插件与市场 | /v1/plugins、/v1/marketplaces、resolved、access 与关系路由 | 发布、解析、成员关系和访问应保持为显式操作。 |
| Skill 与 Skill Hub | /v1/skills、/v1/skill-hubs 与分配/访问路由 | 可复用集合用 Skill Hub；独立能力单元用单个 Skill。 |
| 连接器 | accounts、instances、targets、mappings、discovery、sync events | 保留 account → instance → target → mapping 图，才能在正确节点重试失败同步。 |
| Worker | /v1/workers、runtime、tokens、activity heartbeat | 仅用于组织托管运行时；普通本地桌面工作区不需要 Worker。 |
配置是版本化状态，不是一个大对象
GET /v1/config-objects 是发现路由，支持 cursor 分页、1 至 100 的 limit、type、status、sourceMode、plugin 和 connector-instance 过滤、deleted-resource 选择以及文本查询。请在服务端使用这些过滤条件，而不是在客户端拉取无边界列表。
对象本体、版本历史、最新版本与解析后的形式服务于不同目的。运行时只有在准备消费配置时才需要 resolved 表示；编辑器可能需要某个特定版本；列表视图通常不需要完整历史或解析后的 payload。
控制平面可以保留历史，而不必让每个历史对象都进入运行时。
- 01创建
创建具有类型与元数据的可寻址配置对象。
- 02版本化
新增版本并保留历史记录，而不是覆盖未知状态。
- 03授权
附加目标受众所需的最小访问与插件关系。
- 04解析或退役
运行时读取 resolved 形式，或通过生命周期路由归档、删除、恢复。
连接器与 Worker 是异步系统
使用 connector、discovery、sync 或 Worker 请求返回的资源 ID 查询当前对象。创建成功或 accepted 响应只证明服务收到了请求，不代表远程发现、同步或运行时就绪已经完成。可重试的对象往往是 sync event 或 target，而不是最初 account。
有关路由级 schema、响应状态和安全方案，请以仓库生成的 OpenAPI 合约为准。然后继续阅读 OpenAPI 与集成 与 运行时与 Webhook。