3111404962
9ec6e3ae66
- 为 6 个 Controller 创建了 28 个接口文档 * PartnerAdvancedController: 5 个接口 * PartnerBatchController: 4 个接口 * PartnerConnectionController: 3 个接口 * PartnerCrudController: 6 个接口 * PartnerDescribeController: 6 个接口 * PartnerQueryController: 4 个接口 - 创建 Partner API 接口文档索引 (index.md) 作为唯一真源 - 每个接口文档包含完整的请求/响应参数、错误码和使用说明 - 文档位置: docs/api-docs/partner-api/
233 lines
8.7 KiB
Markdown
233 lines
8.7 KiB
Markdown
# Partner API 接口文档索引
|
||
|
||
## 概述
|
||
|
||
本文档是 `datai-salesforce-partner` 模块所有 API 接口文档的唯一真源索引，记录了所有已创建的接口文档及其元数据。
|
||
|
||
## 文档元数据
|
||
|
||
| 属性 | 值 |
|
||
|------|-----|
|
||
| 文档名称 | Partner API 接口文档索引 |
|
||
| 文档编号 | PARTNER-API-INDEX-001 |
|
||
| 创建日期 | 2026-02-02 |
|
||
| 最后更新 | 2026-02-02 |
|
||
| 状态 | 已完成 |
|
||
| 维护者 | AI Assistant |
|
||
|
||
## 文档统计
|
||
|
||
| Controller | 文档数量 | 接口数量 |
|
||
|------------|----------|----------|
|
||
| PartnerAdvancedController | 5 | 5 |
|
||
| PartnerBatchController | 4 | 4 |
|
||
| PartnerConnectionController | 3 | 3 |
|
||
| PartnerCrudController | 6 | 6 |
|
||
| PartnerDescribeController | 6 | 6 |
|
||
| PartnerQueryController | 4 | 4 |
|
||
| **总计** | **28** | **28** |
|
||
|
||
---
|
||
|
||
## 1. PartnerAdvancedController - 高级功能接口
|
||
|
||
### 接口列表
|
||
|
||
| 序号 | 文档名称 | 接口路径 | 接口名称 | 状态 |
|
||
|------|----------|----------|----------|------|
|
||
| 1 | [001-convert-lead.md](./PartnerAdvancedController/001-convert-lead.md) | `/partner/convertLead` | 转换潜在客户 | ✅ 已完成 |
|
||
| 2 | [002-empty-recycle-bin.md](./PartnerAdvancedController/002-empty-recycle-bin.md) | `/partner/emptyRecycleBin` | 清空回收站 | ✅ 已完成 |
|
||
| 3 | [003-process-submit-request.md](./PartnerAdvancedController/003-process-submit-request.md) | `/partner/processSubmitRequest` | 提交流程请求 | ✅ 已完成 |
|
||
| 4 | [004-get-user-info.md](./PartnerAdvancedController/004-get-user-info.md) | `/partner/getUserInfo` | 获取用户信息 | ✅ 已完成 |
|
||
| 5 | [005-get-server-timestamp.md](./PartnerAdvancedController/005-get-server-timestamp.md) | `/partner/getServerTimestamp` | 获取服务器时间戳 | ✅ 已完成 |
|
||
|
||
### 功能说明
|
||
|
||
提供 Salesforce 高级功能接口，包括潜在客户转换、回收站管理、流程请求处理、用户信息获取等。
|
||
|
||
---
|
||
|
||
## 2. PartnerBatchController - 批量操作接口
|
||
|
||
### 接口列表
|
||
|
||
| 序号 | 文档名称 | 接口路径 | 接口名称 | 状态 |
|
||
|------|----------|----------|----------|------|
|
||
| 1 | [001-batch-create.md](./PartnerBatchController/001-batch-create.md) | `/partner/batchCreate` | 批量创建记录 | ✅ 已完成 |
|
||
| 2 | [002-batch-update.md](./PartnerBatchController/002-batch-update.md) | `/partner/batchUpdate` | 批量更新记录 | ✅ 已完成 |
|
||
| 3 | [003-batch-delete.md](./PartnerBatchController/003-batch-delete.md) | `/partner/batchDelete` | 批量删除记录 | ✅ 已完成 |
|
||
| 4 | [004-batch-upsert.md](./PartnerBatchController/004-batch-upsert.md) | `/partner/batchUpsert` | 批量 Upsert 记录 | ✅ 已完成 |
|
||
|
||
### 功能说明
|
||
|
||
提供批量操作接口，支持批量创建、更新、删除和 Upsert 记录，提高数据操作效率。
|
||
|
||
---
|
||
|
||
## 3. PartnerConnectionController - 连接管理接口
|
||
|
||
### 接口列表
|
||
|
||
| 序号 | 文档名称 | 接口路径 | 接口名称 | 状态 |
|
||
|------|----------|----------|----------|------|
|
||
| 1 | [001-get-session-info.md](./PartnerConnectionController/001-get-session-info.md) | `/partner/getSessionInfo` | 获取会话信息 | ✅ 已完成 |
|
||
| 2 | [002-get-user-info.md](./PartnerConnectionController/002-get-user-info.md) | `/partner/getUserInfo` | 获取用户信息 | ✅ 已完成 |
|
||
| 3 | [003-change-password.md](./PartnerConnectionController/003-change-password.md) | `/partner/changePassword` | 修改密码 | ✅ 已完成 |
|
||
|
||
### 功能说明
|
||
|
||
提供连接管理接口，包括会话信息获取、用户信息获取和密码修改等。
|
||
|
||
---
|
||
|
||
## 4. PartnerCrudController - CRUD 操作接口
|
||
|
||
### 接口列表
|
||
|
||
| 序号 | 文档名称 | 接口路径 | 接口名称 | 状态 |
|
||
|------|----------|----------|----------|------|
|
||
| 1 | [001-create-record.md](./PartnerCrudController/001-create-record.md) | `/partner/createRecord` | 创建记录 | ✅ 已完成 |
|
||
| 2 | [002-retrieve-record.md](./PartnerCrudController/002-retrieve-record.md) | `/partner/retrieveRecord` | 检索记录 | ✅ 已完成 |
|
||
| 3 | [003-update-record.md](./PartnerCrudController/003-update-record.md) | `/partner/updateRecord` | 更新记录 | ✅ 已完成 |
|
||
| 4 | [004-delete-record.md](./PartnerCrudController/004-delete-record.md) | `/partner/deleteRecord` | 删除记录 | ✅ 已完成 |
|
||
| 5 | [005-upsert-record.md](./PartnerCrudController/005-upsert-record.md) | `/partner/upsertRecord` | Upsert 记录 | ✅ 已完成 |
|
||
| 6 | [006-merge-records.md](./PartnerCrudController/006-merge-records.md) | `/partner/mergeRecords` | 合并记录 | ✅ 已完成 |
|
||
|
||
### 功能说明
|
||
|
||
提供完整的 CRUD 操作接口，支持记录的创建、检索、更新、删除、Upsert 和合并操作。
|
||
|
||
---
|
||
|
||
## 5. PartnerDescribeController - 对象描述接口
|
||
|
||
### 接口列表
|
||
|
||
| 序号 | 文档名称 | 接口路径 | 接口名称 | 状态 |
|
||
|------|----------|----------|----------|------|
|
||
| 1 | [001-describe-global.md](./PartnerDescribeController/001-describe-global.md) | `/partner/describeGlobal` | 描述所有可用对象 | ✅ 已完成 |
|
||
| 2 | [002-describe-sobject.md](./PartnerDescribeController/002-describe-sobject.md) | `/partner/describeSObject` | 描述特定对象 | ✅ 已完成 |
|
||
| 3 | [003-describe-sobjects.md](./PartnerDescribeController/003-describe-sobjects.md) | `/partner/describeSObjects` | 描述多个对象 | ✅ 已完成 |
|
||
| 4 | [004-describe-layout.md](./PartnerDescribeController/004-describe-layout.md) | `/partner/describeLayout` | 描述对象布局 | ✅ 已完成 |
|
||
| 5 | [005-describe-tabs.md](./PartnerDescribeController/005-describe-tabs.md) | `/partner/describeTabs` | 描述标签页 | ✅ 已完成 |
|
||
| 6 | [006-describe-quick-actions.md](./PartnerDescribeController/006-describe-quick-actions.md) | `/partner/describeQuickActions` | 描述快速操作 | ✅ 已完成 |
|
||
|
||
### 功能说明
|
||
|
||
提供对象描述接口，用于获取 Salesforce 对象的元数据信息，包括对象结构、字段定义、布局信息等。
|
||
|
||
---
|
||
|
||
## 6. PartnerQueryController - 查询接口
|
||
|
||
### 接口列表
|
||
|
||
| 序号 | 文档名称 | 接口路径 | 接口名称 | 状态 |
|
||
|------|----------|----------|----------|------|
|
||
| 1 | [001-query.md](./PartnerQueryController/001-query.md) | `/partner/query` | 执行 SOQL 查询 | ✅ 已完成 |
|
||
| 2 | [002-query-all.md](./PartnerQueryController/002-query-all.md) | `/partner/queryAll` | 查询所有记录（包括已删除的） | ✅ 已完成 |
|
||
| 3 | [003-query-more.md](./PartnerQueryController/003-query-more.md) | `/partner/queryMore` | 获取查询结果的下一页 | ✅ 已完成 |
|
||
| 4 | [004-search.md](./PartnerQueryController/004-search.md) | `/partner/search` | 执行 SOSL 搜索 | ✅ 已完成 |
|
||
|
||
### 功能说明
|
||
|
||
提供查询接口，支持 SOQL 查询、QueryAll 查询（包括已删除记录）、分页查询和 SOSL 全文搜索。
|
||
|
||
---
|
||
|
||
## 文档变更日志
|
||
|
||
| 版本 | 日期 | 变更内容 | 作者 |
|
||
|------|------|----------|------|
|
||
| 1.0.0 | 2026-02-02 | 初始版本，创建所有 28 个接口文档的索引 | AI Assistant |
|
||
|
||
---
|
||
|
||
## 交叉引用
|
||
|
||
### 相关文档
|
||
|
||
- [datai-scene-salesforce 模块文档](../../index.md)
|
||
- [Partner API 总览](../partner-api-overview.md)
|
||
|
||
### 外部链接
|
||
|
||
- [Salesforce Partner API 官方文档](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/)
|
||
|
||
---
|
||
|
||
## 维护说明
|
||
|
||
### 文档更新规则
|
||
|
||
1. **新增接口**：当添加新的接口时，必须：
|
||
- 创建对应的接口文档
|
||
- 更新本文档索引
|
||
- 更新文档统计信息
|
||
- 添加变更日志记录
|
||
|
||
2. **修改接口**：当修改现有接口时，必须：
|
||
- 更新对应的接口文档
|
||
- 更新接口文档的版本号和变更日志
|
||
- 在本文档中记录变更
|
||
|
||
3. **删除接口**：当删除接口时，必须：
|
||
- 标记对应的接口文档为已废弃
|
||
- 更新本文档索引状态
|
||
- 添加变更日志记录
|
||
|
||
### 文档命名规范
|
||
|
||
- Controller 文档夹：`{ControllerName}`
|
||
- 接口文档：`{序号}-{接口名称}.md`
|
||
- 序号格式：3 位数字，从 001 开始递增
|
||
|
||
### 文档模板
|
||
|
||
所有接口文档应遵循统一的模板格式，包含以下章节：
|
||
- 接口概述
|
||
- 基本信息
|
||
- 请求参数
|
||
- 响应参数
|
||
- 错误码
|
||
- 使用说明
|
||
- 相关接口
|
||
- 更新日志
|
||
|
||
---
|
||
|
||
## 附录
|
||
|
||
### A. 接口分类统计
|
||
|
||
| 分类 | 接口数量 | 占比 |
|
||
|------|----------|------|
|
||
| 高级功能 | 5 | 17.86% |
|
||
| 批量操作 | 4 | 14.29% |
|
||
| 连接管理 | 3 | 10.71% |
|
||
| CRUD 操作 | 6 | 21.43% |
|
||
| 对象描述 | 6 | 21.43% |
|
||
| 查询功能 | 4 | 14.29% |
|
||
| **总计** | **28** | **100%** |
|
||
|
||
### B. 请求方法统计
|
||
|
||
| 方法 | 接口数量 | 占比 |
|
||
|------|----------|------|
|
||
| POST | 28 | 100% |
|
||
| GET | 0 | 0% |
|
||
| PUT | 0 | 0% |
|
||
| DELETE | 0 | 0% |
|
||
|
||
### C. 文档完成状态
|
||
|
||
| 状态 | 文档数量 | 占比 |
|
||
|------|----------|------|
|
||
| ✅ 已完成 | 28 | 100% |
|
||
| 🚧 进行中 | 0 | 0% |
|
||
| ❌ 未开始 | 0 | 0% |
|
||
|
||
---
|
||
|
||
**文档结束**
|