HoloMotion Algorithm Platform

正在验证平台访问权限…

Remote Report API

IP 白名单管理

管理允许调用远程报告计算接口的客户端 IP。支持单个 IPv4/IPv6 地址和 CIDR 网段。

0条记录0条启用

安全边界

只有启用且匹配的来源 IP 才能访问远程报告接口。代理部署必须先配置可信代理，系统才会采信 X-Forwarded-For；不要把整个公网或不受控的大网段加入白名单。

IP / CIDR

新增白名单记录

名称IP 或 CIDR说明立即启用

Allowlist

允许的客户端

正在加载白名单…

API v1

远程调用说明

POST/api/v1/reports/calculate

同步调用

不提供 callback_url，连接会等待计算完成并直接返回完整报告。

异步调用

提供 callback_url 后立即返回任务标识；完成后系统向回调地址 POST 结果。

采集来源

可上传 .hmpd.zip，或在 JSON 中使用 base64、受控 local_path、HTTP/HTTPS URL。

{
  "algorithm": "moreactionlinux",
  "version": "v2_internal_stable_20260711",
  "source": {
    "type": "url",
    "value": "https://storage.example.com/capture.hmpd.zip"
  },
  "callback_url": "https://consumer.example.com/hooks/report"
}

同步超时或回调失败时可查询： GET /api/v1/reports/jobs/{request_id}

Response / Callback

返回与回调推送数据结构

以下示例与接口实际使用的 hm.remote_report_callback.v1 结构一致。异步回调会把同一终态结构 POST 到 callback_url。

{
  "schema": "hm.remote_report_callback.v1",
  "mode": "sync",
  "request_id": "remote_1784518260961595000",
  "job_id": "job_1784518260956064000",
  "status": "passed",
  "algorithm": "moreactionlinux",
  "version": "v2_internal_stable_20260711",
  "duration_ms": 9061,
  "report": {
    "algorithm": "moreactionlinux",
    "groupName": "专业版",
    "scene": "MoreAction",
    "report": {},
    "diagnostics": {},
    "workbenchPerformance": {
      "total_ms": 9061,
      "phases": []
    },
    "workbenchRulepack": {}
  },
  "created_at": "2026-07-20T08:00:00Z",
  "completed_at": "2026-07-20T08:00:09Z"
}

示例为便于阅读缩略了 report 内部内容；实际同步响应、成功回调和成功状态查询都会返回完整报告对象。失败或取消时不返回 report，并通过 error 给出原因。

字段	类型	含义	出现时机
`schema`	string	固定为 hm.remote_report_callback.v1。	始终
`mode`	string	调用模式：sync 或 async。	始终
`request_id`	string	远程请求 ID，用于状态查询。	始终
`job_id`	string	底层报告计算任务 ID。	始终
`status`	string	queued、running、passed、failed 或 cancelled。	始终
`algorithm / version`	string	实际采用的算法与规则包版本。	始终
`duration_ms`	number	计算耗时，单位毫秒。	任务产生耗时后
`report`	object	完整 MoreAction 报告数据。	status 为 passed
`error`	string	计算、等待或回调相关错误信息。	发生错误时
`callback`	object	回调状态、次数、HTTP 状态及投递时间。	mode 为 async
`created_at / completed_at`	string	UTC RFC 3339 创建与完成时间。	创建时间始终；完成时间在终态