> ## Documentation Index
> Fetch the complete documentation index at: https://rpa.bazhuayu.com/helpcenter/llms.txt
> Use this file to discover all available pages before exploring further.

# 机器人调度-启动单个应用

> 机器人调度-启动单个应用（八爪鱼RPA 开放 API 接口）

认证方式：`Authorization: Bearer <token>`

企业上下文：请求头 `EnterpriseId: <enterpriseId>`（可选，缺省为个人版）

请求体大小限制：单次 10 MB

## **请求**

| **Url**  | [https://api-rpa.bazhuayu.com/api/v1/bots/scheduling/start](https://api-rpa.bazhuayu.com/api/v1/bots/scheduling/start) |
| -------- | ---------------------------------------------------------------------------------------------------------------------- |
| **请求方式** | **POST**                                                                                                               |

### **1. 请求头**

| **字段**        | **值**                            |
| ------------- | -------------------------------- |
| Content-Type  | application/json                 |
| Authorization | `Bearer <token>`                 |
| EnterpriseId  | `<enterpriseId>` 对应企业id，个人版则无需指定 |

**请求头示例**

POST /api/v1/bots/scheduling/start HTTP/1.1

| 名称            | 值                |
| ------------- | ---------------- |
| Content-Type  | application/json |
| Authorization | `Bearer <token>` |
| EnterpriseId  | 64f1e6a2...      |

###

### 2. 请求参数

| **参数名称**                    | **类型** | **必须** | **描述**                                                                                                           |
| --------------------------- | ------ | ------ | ---------------------------------------------------------------------------------------------------------------- |
| flowId                      | string | 是      | 应用 Id                                                                                                            |
| flowContentRetrievalMode    | string | 否      | 应用内容获取方式，取值： `ByNewestContent`默认值，表示获取应用最新内容 `ByDefaultPublication`表示获取应用最新版本 `BySpecifiedPublication`表示获取应用指定版本 |
| specifiedPublicationVersion | string | 否      | 指定应用版本号；当模式为 `BySpecifiedPublication` 时提供                                                                        |
| specifiedBot                | string | 否      | 指定机器人 Id；不填则为任意机器人                                                                                               |
| params                      | object | 否      | 应用运行参数键值对，如 `\{ "key": value \}`                                                                                 |

###

### 3. 请求示例

请求体：

```
{
  "flowId": "flow_123",
  "flowContentRetrievalMode": "BySpecifiedPublication",
  "specifiedPublicationVersion": "1",
  "specifiedBot": "bot_id_001",
  "params": {
    "date": "2025-10-01",
    "retry": 2
  }
}
```

### 4. 返回结果

成功响应体：

| **名称**        | **类型** | **是否必须** | **描述**     |
| ------------- | ------ | -------- | ---------- |
| flowId        | string | 是        | 已启动的应用 Id  |
| flowProcessNo | string | 是        | 启动应用生成的批次号 |

返回示例：

```
{
  "flowId": "flow_123",
  "flowProcessNo": "638973213311975754"
}
```

失败响应体：

| **名称**      | **类型** | **是否必须** | **描述**  |
| ----------- | ------ | -------- | ------- |
| code        | string | 是        | 错误码     |
| description | string | 是        | 错误描述    |
| requestId   | string | 否        | 请求追踪 ID |