应用数据服务

application-data-service 为已授权应用、数字员工和团队管理员 Key 提供统一的 JSON 数据记录写入、读取、查询、删除和组织数据主体汇总能力。

能力信息

字段	值
能力 Key	`application-data-service`
能力名称	应用数据服务
能力类型	`application_data_service`
分类	FunClaw通用能力
开放状态	通过应用数据 REST API 调用

授权动作

管理员向应用、数字员工或组织级 Key 授权 application-data-service后，服务端会展开为 record.write、record.read、record.query、record.delete、collection.list、organization.data.owner.list、organization.data.owner.collection.list和 organization.data.owner.record.query。调用方不需要在请求体里传这些动作 key。

普通资源空间

应用 Key 和数字员工 Key 读写当前 Key 对应的资源空间。调用方不要额外传orgId、applicationId、employeeId 或资源域 ID；服务端会从 Key 解析团队、调用主体和数据归属。


POST /api/open/v1/capabilities/application-data-service/recordsPUT  /api/open/v1/capabilities/application-data-service/collections/{collectionKey}/records/{recordId}PATCH /api/open/v1/capabilities/application-data-service/collections/{collectionKey}/records/{recordId}POST /api/open/v1/capabilities/application-data-service/records:batchPutPOST /api/open/v1/capabilities/application-data-service/records:batchDeleteGET  /api/open/v1/capabilities/application-data-service/collections/{collectionKey}/records/{recordId}GET  /api/open/v1/capabilities/application-data-service/collections/{collectionKey}/recordsDELETE /api/open/v1/capabilities/application-data-service/collections/{collectionKey}/records/{recordId}GET  /api/open/v1/capabilities/application-data-service/collectionsAuthorization: Bearer <sk-application-or-digital-employee-key>Content-Type: application/json

写入记录


{  "collectionKey": "todos",  "recordId": "todo-001",  "data": {    "title": "整理客户拜访清单",    "done": false  },  "metadata": {    "source": "codex-skill"  }}

批量写入


{  "records": [    {      "collectionKey": "todos",      "recordId": "todo-001",      "data": {        "title": "整理客户拜访清单",        "done": false      },      "metadata": {        "source": "codex-skill"      }    }  ]}

团队公共数据

团队公共数据使用同一个 application-data-service 能力。读取、查询和列集合可以使用已授权的应用 Key 或数字员工 Key；写入、更新、删除和批量变更必须使用团队管理员创建的 ORG_ADMIN_KEY。该 Key 的资源范围等于当前组织，用于外部 Codex、插件或 Skill 维护团队级公共配置、模板和共享记录。


POST /api/open/v1/capabilities/application-data-service/organization/recordsPUT  /api/open/v1/capabilities/application-data-service/organization/collections/{collectionKey}/records/{recordId}PATCH /api/open/v1/capabilities/application-data-service/organization/collections/{collectionKey}/records/{recordId}POST /api/open/v1/capabilities/application-data-service/organization/records:batchPutPOST /api/open/v1/capabilities/application-data-service/organization/records:batchDeleteGET  /api/open/v1/capabilities/application-data-service/organization/collections/{collectionKey}/records/{recordId}GET  /api/open/v1/capabilities/application-data-service/organization/collections/{collectionKey}/recordsDELETE /api/open/v1/capabilities/application-data-service/organization/collections/{collectionKey}/records/{recordId}GET  /api/open/v1/capabilities/application-data-service/organization/collectionsGET  /api/open/v1/capabilities/application-data-service/organization/ownersGET  /api/open/v1/capabilities/application-data-service/organization/owners/{resourceScopeType}/{resourceScopeId}/collectionsGET  /api/open/v1/capabilities/application-data-service/organization/owners/{resourceScopeType}/{resourceScopeId}/collections/{collectionKey}/recordsAuthorization: Bearer <authorized-key-for-read-or-ORG_ADMIN_KEY-for-write>Content-Type: application/json

当外部 Codex 或插件需要回答“当前组织内有哪些人保存了数据”“哪些应用或数字员工写过数据”等跨主体汇总问题时，先调用 GET /api/open/v1/capabilities/application-data-service/organization/owners。该接口返回 owner 级摘要；如果还要查看某个 owner 的数据细节，用返回的 resourceScopeType和 resourceScopeId 继续调用 owner collections 和 owner records 端点。 owner 汇总和明细必须使用 ORG_ADMIN_KEY，并拥有对应的organization.data.owner.list、organization.data.owner.collection.list、organization.data.owner.record.query 或 organization.data.owner.* 授权。

写入团队公共记录


{  "collectionKey": "team.settings",  "recordId": "defaults",  "data": {    "timezone": "Asia/Shanghai",    "language": "zh-CN"  },  "metadata": {    "owner": "organization-admin"  }}

响应示例


{  "id": "dddddddd-dddd-dddd-dddd-dddddddddddd",  "orgId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",  "collectionKey": "todos",  "recordId": "todo-001",  "data": {    "title": "整理客户拜访清单",    "done": false  },  "metadata": {    "source": "codex-skill"  },  "createdAt": "2026-06-23T08:00:00Z",  "updatedAt": "2026-06-23T08:00:00Z"}

权限与提示

读取、查询和列集合可以使用已授权的应用 Key 或数字员工 Key；这些 Key 仍然需要显式拥有应用数据服务授权。
写入、更新、删除和批量变更必须使用团队管理员创建的 ORG_ADMIN_KEY。
组织数据主体汇总和明细接口 /organization/owners... 也必须使用 ORG_ADMIN_KEY；缺少 organization.data.owner.list、organization.data.owner.collection.list、organization.data.owner.record.query 或 organization.data.owner.* 时，应提示管理员补充应用数据服务或该组织级汇总/明细授权。
当团队公共数据写/删、owner 汇总或 owner 明细接口返回 403 且提示包含 ORG_ADMIN_KEY 时，客户端应提示：当前连接 Key 不能操作团队公共数据，请使用团队管理员创建的 ORG_ADMIN_KEY。
如果读/查/列返回缺少 application-data-service 授权，先让团队管理员在应用或 Key 配置里补授权，再重试。

共享媒体源服务应用资产服务