SourceFinder API

SourceFinder 服务的公开 OpenAPI 参考文档。

Base URL

https://api.coinpost.ai/sourcefinder

鉴权方式

通过 CP-X-API-KEY 请求头传递 API Key。

格式示例：

CP-X-API-KEY: <your-api-key>

接口

• GET /health — 健康检查
• POST /sources — 提交异步溯源任务
• GET /sources/{id} — 获取溯源任务状态或结果
• POST /entities/extractions — 提交异步实体抽取任务
• GET /entities/extractions/{id} — 获取实体抽取任务状态或结果
• GET /entities — 列出近期任务中观察到的聚合实体

请求说明

• POST /sources 需至少提供 title、content、source_urls 之一
• 可选的请求级 LLM 覆盖参数放在 llm 下
• collected_at 可为不完整或相对日期提供参考时间
• 实体抽取会运行 planner LLM 路径，因此是异步接口：先用 text 调用 POST /entities/extractions，再用返回的 job_id 轮询 GET /entities/extractions/{id}
• 溯源任务 ID 与实体抽取任务 ID 使用各自独立的结果查询接口

响应约定

• 任务响应将数据包装在 data 字段中；/health 直接返回服务元数据
• 错误响应返回 error 及错误信息字符串
• 任务结果包含 status 字段（pending、processing、completed、failed）
• 完成后的溯源结果可包含 primary_sources、original_urls、指标和 truth_assessment；完成后的实体抽取结果包含 entities