Generate
报告生产工作台
模板配置
业务线选择
任务生成
文案调整
01
模板与客户
设置报告类型、客户名称和统计时间范围。
02
业务线客户
点击读取报告后会自动搜索并加载可用业务线。
| 客户 / 业务线 | enterprise_id | 完整报表数 | 最近报表 | |
|---|---|---|---|---|
| 搜索后选择业务线客户 | ||||
03
客户报表
同一 enterprise_id 下可勾选多期完整任务，按时间合成为趋势。
| 客户 | 报表名称 | 报表日期 | |
|---|---|---|---|
| 请先填写客户名称并点击读取报告 | |||
请先选择业务线和报表。
04
文案调整
在报告预览中直接编辑 AI 生成文案；数据和图表保持锁定。
从任务进程或报告库点击“编辑文案”后，可编辑文字会在预览中高亮。
Preview
报告预览
生成后会在这里显示固定模板 HTML。
Jobs
任务进程
生成任务
生成任务按顺序执行，后续任务会自动排队。
暂无生成任务
Runtime
系统配置
当前模型
-
- 协议
- -
- 模型
- -
- 配置来源
- -
- 密钥指纹
-
模型连接
保存成功后，新开始的模型任务立即使用新配置。
Library
报告库
已生成报告
本地保存的 HTML、report_data.json 和 copy_blocks.json。
| 报告名称 | 客户 | 类型 | 周期 | 生成时间 | 操作 |
|---|---|---|---|---|---|
| 暂无已生成报告 | |||||
Archive Preview
报告库预览
从左侧报告库中打开已生成报告。
Integration
OpenAPI 管理台
管理调用凭证、访问范围和可追溯的报告生成链路。
尚未加载
应用列表
每个应用绑定一个客户，并限制业务线与模板范围。
| 应用 | 客户 | 范围 | 状态 | 最近调用 |
|---|---|---|---|---|
| 进入模块后加载应用 | ||||
Create App
创建应用
保存后 AppKey 只展示一次，请立即妥善保存。
调用日志
按请求与任务编号定位调用；敏感认证信息不会展示。
| 调用时间 | 应用 / 客户 | 接口 | 状态 | 耗时 | Request ID | Job ID |
|---|---|---|---|---|---|---|
| 暂无调用日志 | ||||||
POST
/openapi/v1/report-options/query
查询可选参数
输入模板与客户名称，返回可选业务线、离散报告时间点以及模板选择规则。日期只用于展示，后续提交使用 report_id。
template_idstring · 必填
稳定的报告模板代号。
client_namestring · 必填App 绑定的标准客户名称。
paginationobject · 可选传入 enterprise_id 与 cursor，查询该业务线更早的50份报告。
curl -X POST 'https://geo-report.geokeji.com/openapi/v1/report-options/query' \
-H 'Authorization: Bearer <APP_KEY>' \
-H 'Content-Type: application/json' \
-d '{"template_id":"geo_single_business_line_trend","client_name":"示例客户"}'{
"request_id": "req_xxx",
"data": {
"client": {"client_id": "client_xxx", "client_name": "示例客户"},
"selection_rules": {"selection_mode": "single_line_multi_report"},
"business_lines": [{"enterprise_id": "enterprise_001", "reports": []}]
}
}
POST
/openapi/v1/report-jobs
创建生成任务
提交精确的 enterprise_id 与 report_id。服务端重新验证归属和模板规则，成功返回 202 与 job_id。
client_idstring · 必填
第一步返回的 OpenAPI 客户 ID。
template_idstring · 必填已获授权的模板代号。
selectionsarray · 必填业务线及其选中的 report_ids。
client_reference_idstring · 可选调用方自己的业务编号。
curl -X POST 'https://geo-report.geokeji.com/openapi/v1/report-jobs' \
-H 'Authorization: Bearer <APP_KEY>' \
-H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' \
-H 'Content-Type: application/json' \
-d '{"client_id":"client_xxx","template_id":"geo_single_business_line_trend","selections":[{"enterprise_id":"enterprise_001","report_ids":["report_1001","report_1002"]}]}'{
"request_id": "req_xxx",
"data": {"job_id": "job_xxx", "status": "queued", "status_url": "/openapi/v1/report-jobs/job_xxx"}
}
GET
/openapi/v1/report-jobs/{job_id}
查询任务进度
轮询任务状态。状态为 succeeded 时，result.report_url 是可直接打开的永久公开链接。
queued→running→succeeded或 failed / cancelled
curl 'https://geo-report.geokeji.com/openapi/v1/report-jobs/job_xxx' \
-H 'Authorization: Bearer <APP_KEY>'{
"request_id": "req_xxx",
"data": {
"job_id": "job_xxx", "status": "succeeded",
"progress": {"percent": 100, "stage": "done", "message": "报告生成完成"},
"result": {"report_url": "https://geo-report.geokeji.com/r/share_xxx"}
}
}统一响应与错误
成功数据位于 data；失败响应包含 request_id、error.code、error.message 和可选 details。常见状态码为 401、403、404、409、422、429 和 503。
{
"request_id": "req_xxx",
"error": {
"code": "SELECTION_RULE_VIOLATION",
"message": "所选报告不符合模板要求",
"details": []
}
}Live Request
真实接口测试
密钥仅保存在当前页面内存；刷新或离开页面后会清空。
01
查询可选参数
选择模板并输入 App 绑定的客户名称。
02
创建生成任务
确认精确选择，提交后立即获得任务 ID。
请求预览
尚未选择报告
{}
03
查询任务进度
创建后自动轮询，也可输入已有任务 ID。
等待创建任务。