澈知工业中枢｜服务门户
开发者中心
围绕风险告警、决策简报与行情信号逐步开放集成能力
接口文档中心
当前开放接口与字段说明
本页列出当前版本已经开放的标准接口、所需权限范围与请求响应样例。 当前统一采用组织级 API Key 进行外部系统鉴权。
鉴权方式
请求头
Authorization: ApiKey <your-key> X-API-Key: <your-key>
调用约束
每个外部系统建议使用独立 Key，避免多系统共用同一令牌。
生产写入类接口默认仅开放给经过组织管理员确认的接入方。
Key 的完整明文仅在创建时展示一次，请妥善保管。
权限范围
告警读取
radar.alerts:read
读取租户范围内的关键供应链预警信息。
决策简报读取
radar.briefs:read
读取租户范围内已经复核的决策简报。
行情信号读取
radar.market_signals:read
提取和标准化相关宏观与微观变量行情信号。
关注范围读取
radar.watch-scope:read
查询当前租户监控的物料及上下游供应商边界。
GET告警读取
最新预警快报
获取已开启关注范围内的关键供应链告警和重大事件。
/api/v1/radar/alerts典型用途
整合到内部协同门户
对接企业自建预警大屏
响应样例
{
"data": [
{
"id": "alert-1",
"alert_type": "SUPPLY_DISRUPTION",
"severity": "HIGH",
"title": "关键材料供应风险",
"status": "OPEN"
}
],
"meta": {
"limit": 50,
"next_cursor": null,
"as_of": "2026-07-16T08:00:00Z",
"request_id": "request-1"
}
}GET决策简报读取
分析简报与周报
读取系统自动生成的日报和特定品类趋势周报。
/api/v1/radar/briefs典型用途
自动分发至高管邮箱或微信推送群
响应样例
{
"data": [
{
"brief_id": "candidate:brief-1",
"brief_type": "observation",
"decision_level": "L1",
"title": "关键材料供应风险 - 待 Radar 复核"
}
],
"meta": {
"limit": 50,
"next_cursor": null,
"as_of": "2026-07-16T08:00:00Z",
"request_id": "request-1"
}
}GET行情信号读取
宏观与微观信号
获取经过提炼和标准化的市场行情和指标波动数据。
/api/v1/radar/market-signals典型用途
汇入自建数据仓库
量化模型特征补充
响应样例
{
"data": [
{
"signal_id": "sig-101",
"variable_code": "SHFE_CU",
"value": 72550.0,
"daily_change_pct": 0.015,
"as_of": "2026-03-20T00:00:00Z"
}
],
"meta": {
"limit": 50,
"next_cursor": null,
"as_of": "2026-07-16T08:00:00Z",
"request_id": "request-1"
}
}GET关注范围读取
监控边界画像
查询当前授权租户所配置的关注物料与供应商范围。
/api/v1/radar/watch-scope典型用途
同步企业信息确认目前覆盖是否完备
响应样例
{
"data": {
"watched_materials": ["阴极铜", "铝锭"],
"watched_suppliers": ["供应商A", "供应商B"],
"source": "intel_supplier_risk_profile"
}
}