开发者服务
开发者服务概述
开发者服务提供了一系列API，用于管理和操作外脑平台的各种资源，包括应用、工具、模型、任务等。这些API需要开发者权限才能访问。
所有开发者服务接口都需要有效的访问令牌，并且调用者必须具有开发者权限。请在请求头中包含Bearer令牌。
通用接口
获取资源模式
获取指定资源类型的数据模式。请求参数
GET /dev/schema?type=app
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
检查资源指针
检查资源指针的有效性。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| type | string | 是 | 资源类型 |
| pointer | string | 是 | 资源指针 |
GET /dev/pointer?type=app&pointer=app_123
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
获取资源列表
获取指定类型的资源列表。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| type | string | 是 | 资源类型 |
| page | integer | 否 | 页码，默认1 |
| size | integer | 否 | 每页数量 |
GET /dev/list?type=app&page=1&size=10
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
错误码说明
错误码说明
| 错误码 | 说明 |
|---|
| 400 | 请求参数错误 |
| 401 | 未授权或令牌无效 |
| 403 | 权限不足（需要开发者权限） |
| 404 | 资源不存在 |
| 422 | 请求参数验证失败 |
| 500 | 服务器错误 |
开发者服务分类
开发者服务包含以下几类API：
- 应用管理 - 管理外脑应用
- 工具管理 - 管理工具资源
- 模型管理 - 管理AI模型
- 任务管理 - 管理后台任务
- 对话管理 - 管理对话资源
- 机器人管理 - 管理机器人
- 硬件管理 - 管理硬件设备
- 向量数据库 - 管理向量数据
