---
title: "控制后台运行器"
method: POST
path: "/api/runner/control"
tags: ["运行器管理"]
---

# 控制后台运行器

`POST /api/runner/control`

执行启动、停止、重启、强制停止或热重载操作

## Request body

- DtoRunnerControlRequest
  - `action` 'start' | 'stop' | 'restart' | 'force_stop' | 'reload', required — 控制动作

## Response `200`

操作成功

- object — 成功的API响应标准格式
  - `code` integer
  - `data` DtoRunnerControlResponse
    - `action` string — 执行的动作
    - `message` string — 操作消息
    - `state` string — 操作后的状态
    - `success` boolean — 操作是否成功
  - `message` string
  - `requestId` string
  - `success` boolean
  - `timestamp` string

## Other responses

- `400` — 请求参数错误
- `500` — 服务器内部错误

---

[API](https://skmtc.net/labring/apis/ruiqi-waf-api.md) · [All operations](https://skmtc.net/labring/apis/ruiqi-waf-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/labring/ruiqi-waf-api/versions/aaacd7e06a88/schema)