跳到主要内容

删除因子路线

DELETE/research/factor-routes/{code}在线调试
DELETE https://api.shengkezhi.com/open/v1/research/factor-routes/STRAT_MOMENTUM_001?force=True&dry_run=True
等效 curl
curl "https://api.shengkezhi.com/open/v1/research/factor-routes/STRAT_MOMENTUM_001?force=True&dry_run=True" \
  -H "Authorization: Bearer sk_xxx"

DELETE /research/factor-routes/{code} — 删除因子路线。

删除研究路线并级联清理其因子、标签、评估、汇总和挖掘执行。可用 dry_run 预演,触发软护栏时需明确传 force=true。

需在请求头携带 Authorization: Bearer sk_xxx。

请求参数​

参数位置类型必填默认值说明
codepathstring是-研究路线编码
forcequeryboolean否-越过两条软护栏:「名下仍有因子」与「挖掘执行目录最近仍有写入」。
dry_runqueryboolean否-只预演不写:返回将删除的挖掘执行数与将删除的因子数,不做任何修改。

响应 data​

字段类型必填说明
deletedboolean是是否已实际删除;dry_run=true 时恒为 false。路线为物理删除,不做软删。
deleted_factorsinteger是因子数(含已软删因子):预演时是「将删除」,实删时是「已删除」。
dry_runboolean是本次是否为预演。
failed_mining_runsstring[]是未能删除的挖掘执行编号。非空表示部分失败,重试同一请求可续删(删除幂等)。
mining_runsinteger是挖掘执行数:预演时是「将删除」,实删时是「已成功删除」。
orphaned_factorsinteger是兼容旧客户端的字段;级联删除后不会留下孤儿因子,恒为 0。
route_codestring是被删除的研究路线编码,回显路径参数。

HTTP 状态​

状态码说明
200删除预演或实际删除结果
404研究路线、关联因子及挖掘执行均不存在
409路线仍有关联因子或执行目录近期仍有写入;确认后可带 force 重试
500检查或删除路线产物失败

调用示例​

curl -X DELETE "https://api.shengkezhi.com/open/v1/research/factor-routes/STRAT_MOMENTUM_001" \
-H "Authorization: Bearer sk_xxx"
{
"code": 0,
"msg": "ok",
"data": {
"deleted": true,
"dry_run": true,
"failed_mining_runs": [
"示例Failed mining runs"
],
"mining_runs": 1,
"deleted_factors": 1,
"orphaned_factors": 0,
"route_code": "STS_BJ60MIN_LEADERS"
}
}