API 文档

公开文档页不显示任何令牌。

鉴权

Authorization: Bearer <API_TOKEN>

API 令牌保存在服务数据目录的 .export-token。控制台令牌保存在 .frontend-token,两者独立。

公共接口

方法路径说明
GET/health健康检查
POST/webhooks/smsforwarder短信回调,无 Bearer

导出接口

方法路径说明
GET/api/v1/sources数据源,包含 available 和 availability_error
POST/api/v1/jobs创建任务;暂不可用源返回 503 和“接口暂不可用”
GET/api/v1/jobs任务列表
GET/api/v1/jobs/{id}任务状态
GET/api/v1/jobs/{id}/download下载文件

创建任务

{"source":"sap","parameters":{"orgs":["6816"],"from_date":"2026-01-01","to_date":"2026-01-01"}}

cis、DT 明细表、截图源和日报源使用 from_date、to_date;source 名称由 /api/v1/sources 返回。

截图源:cis_sales_screenshot、cis_finance_screenshot、cis_core_metrics_screenshot。输出为单个 PNG;销售和财务截图使用 iframe 内容 90% 缩放并截取前两行共 6 个面板,核心指标截图保留前部全部核心指标。

日报源:cis_daily_report。一次任务选择“空调”及“海信空调”“科龙空调”“璀璨家中”物料组,并下载一个 ZIP,内部包含三张 PNG、AI分析文案.md 和 manifest.json。ZIP 使用 application/zip,服务器检查 CRC、图片签名和非空分析文案。

以下库存明细源暂不提供:cis_rdc_inventory_detail、cis_merchant_model_inventory、cis_merchant_inventory_detail。提交这些 source 返回 HTTP 503:{"error":"接口暂不可用"}。

控制台

控制台页面使用前端令牌登录:/console/exports?token=...。登录后使用 Cookie,不发送 Bearer。