← 返回工作台
灵途 GEO API
文章、素材、客户评价和公众号直接归属组织,无需创建站点。
下载 OpenAPI JSON · 管理中央 Agent API Key
身份与权限
Agent 使用账号中心 API Key;先登录 GEO 并加入组织,由组织管理员授予操作权限。公众号密钥和对象存储密钥仅保存在服务器。
组织文章按 version 修改,改稿后需重新审核;发布只接受当前已审核版本。 组织公众号任务按文章版本、账号与操作去重。版本冲突返回 409。
GET /api/v1/organizations/{organizationId}/articles
Authorization: Bearer <中央 Agent API Key>
POST /api/v1/organizations/{organizationId}/articles
Content-Type: application/json
{"slug":"getting-started","content":{"title":"开始使用","markdown":"# 你好"}}旧官网兼容路径仍保留原归属校验;站点管理已移除,兼容路径在 OpenAPI 中标记 deprecated,现有历史内容和发布任务保留。
| 方法 | 地址 | 用途 |
|---|---|---|
| GET | /api/v1/organizations | 列出本人加入的组织 |
| POST | /api/v1/organizations | 创建组织并成为所有者 |
| GET | /api/v1/organizations/{organizationId} | 组织详情 |
| PATCH | /api/v1/organizations/{organizationId} | 修改组织名称 |
| GET | /api/v1/organizations/{organizationId}/members | 组织成员列表 |
| PATCH | /api/v1/organizations/{organizationId}/members/{userId} | 调整组织成员权限 |
| DELETE | /api/v1/organizations/{organizationId}/members/{userId} | 移除组织成员 |
| GET | /api/v1/organizations/{organizationId}/invites | 组织邀请状态(不返回凭据) |
| POST | /api/v1/organizations/{organizationId}/invites | 创建七天一次性邀请 |
| DELETE | /api/v1/organizations/{organizationId}/invites/{inviteId} | 撤销邀请 |
| POST | /api/v1/organizations/invites/accept | 领取一次性组织邀请 |
| GET | /api/v1/organizations/{organizationId}/articles | 列出组织文章 |
| POST | /api/v1/organizations/{organizationId}/articles | 创建组织文章(无需站点) |
| GET | /api/v1/organizations/{organizationId}/articles/{id} | 组织文章详情 |
| PUT | /api/v1/organizations/{organizationId}/articles/{id} | 保存组织草稿并重置审核 |
| GET | /api/v1/organizations/{organizationId}/articles/{id}/revisions | 组织文章版本、审核或发布历史 |
| GET | /api/v1/organizations/{organizationId}/articles/{id}/reviews | 组织文章版本、审核或发布历史 |
| POST | /api/v1/organizations/{organizationId}/articles/{id}/submit | 提交审核、通过或退回指定版本 |
| POST | /api/v1/organizations/{organizationId}/articles/{id}/approve | 提交审核、通过或退回指定版本 |
| POST | /api/v1/organizations/{organizationId}/articles/{id}/reject | 提交审核、通过或退回指定版本 |
| POST | /api/v1/organizations/{organizationId}/transfer | 将所有权转让给组织内成员 |
| POST | /api/v1/organizations/{organizationId}/leave | 成员主动退出,所有者须先转让 |
| GET | /api/v1/organizations/{organizationId}/audit | 管理员查看组织操作记录 |
| GET | /api/v1/organizations/{organizationId}/channels | 组织关联公众号列表(不含密钥) |
| GET | /api/v1/organizations/{organizationId}/articles/{id}/wechat-publications | 组织文章公众号发布记录 |
| POST | /api/v1/organizations/{organizationId}/articles/{id}/wechat | 将审核版本安排至组织公众号,每版本与操作不重复创建 |
| GET | /api/v1/organizations/{organizationId}/assets | 组织素材元数据列表 |
| POST | /api/v1/organizations/{organizationId}/assets | 申请组织素材上传签名 |
| GET | /api/v1/organizations/{organizationId}/assets/{id} | 读取组织内就绪素材(临时签名跳转) |
| POST | /api/v1/organizations/{organizationId}/assets/{id}/confirm | 核验组织素材的实际大小和类型 |
| GET | /api/v1/organizations/{organizationId}/articles/{id}/check | 检查保存版本的内容结构、来源和待核实标记,不推断收录或引用 |
| GET | /api/v1/organizations/{organizationId}/testimonials | 组织客户评价 |
| POST | /api/v1/organizations/{organizationId}/testimonials | 保存已授权评价 |
| PATCH | /api/v1/organizations/{organizationId}/testimonials/{id} | 审核评价 |
| GET | /api/v1/organizations/{organizationId}/wechat/accounts | 组织关联公众号(不含密钥) |
| POST | /api/v1/organizations/{organizationId}/wechat/accounts | 关联公众号 |
| PUT | /api/v1/organizations/{organizationId}/wechat/accounts/{id} | 修改公众号配置 |
| POST | /api/v1/organizations/{organizationId}/wechat/accounts/{id}/test | 测试公众号连接 |
| GET | /api/v1/organizations/{organizationId}/wechat/publications | 组织公众号发布记录 |
| POST | /api/v1/organizations/{organizationId}/wechat/publications/{id}/reconcile | 核对未知发表回执,禁止自动重发 |
| GET | /api/v1/organizations/{organizationId}/jobs | 组织发布任务 |
| GET | /api/v1/me | 当前身份与 API Key 管理入口 |
| GET | /api/v1/users | 所有者读取已关联用户 |