88 lines
2.5 KiB
Markdown
88 lines
2.5 KiB
Markdown
# 创建用车审批流程实例接口
|
|
|
|
## 接口说明
|
|
|
|
该接口用于外部系统向 E10 发起用车审批流程实例。
|
|
|
|
## 前置条件
|
|
|
|
### 获取 access_token
|
|
|
|
E10 OpenAPI 使用 OAuth2 code 换取 access_token 的方式。业务接口调用时，`access_token` 作为请求体参数传入，不通过 HTTP `Authorization` Header 传入。
|
|
|
|
#### Step 1: 获取 code
|
|
|
|
- **URL**: `POST https://<E10_BASE>/papi/openapi/oauth2/authorize`
|
|
- **Content-Type**: `application/json`
|
|
|
|
| 参数 | 必填 | 类型 | 说明 |
|
|
|---|---|---|---|
|
|
| `corpid` | 是 | String | 企业 corpId。 |
|
|
| `response_type` | 是 | String | 固定为 `code`。 |
|
|
| `state` | 是 | String | 自定义参数。 |
|
|
|
|
#### Step 2: code 换 access_token
|
|
|
|
- **URL**: `POST https://<E10_BASE>/papi/openapi/oauth2/access_token`
|
|
- **Content-Type**: `application/json`
|
|
|
|
| 参数 | 必填 | 类型 | 说明 |
|
|
|---|---|---|---|
|
|
| `app_key` | 是 | String | 应用 key。 |
|
|
| `app_secret` | 是 | String | 应用密钥。 |
|
|
| `grant_type` | 是 | String | 固定为 `authorization_code`。 |
|
|
| `code` | 是 | String | 授权 code。 |
|
|
|
|
## 身份标识转换
|
|
|
|
外部系统应使用工号和部门编号等外部稳定标识传值。人员字段使用 `userType: "JOB_NUM"`，部门字段使用 `deptType: "DEPT_CODE"`。
|
|
|
|
## 请求信息
|
|
|
|
- **URL**: `POST https://<E10_BASE>/papi/openapi/<WORKFLOW_INSTANCE_PATH>`
|
|
- **Content-Type**: `application/json`
|
|
|
|
## 请求示例
|
|
|
|
### 最小请求
|
|
|
|
```bash
|
|
curl -X POST "https://<E10_BASE>/papi/openapi/<WORKFLOW_INSTANCE_PATH>" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"access_token": "<ACCESS_TOKEN>",
|
|
"userType": "JOB_NUM",
|
|
"deptType": "DEPT_CODE",
|
|
"formData": {
|
|
"dataDetails": [
|
|
{
|
|
"dataKey": "applicant",
|
|
"dataOptions": [
|
|
{"type": "resource", "value": "EMP001", "userType": "JOB_NUM"}
|
|
]
|
|
},
|
|
{
|
|
"dataKey": "vehicleDate",
|
|
"content": "2026-06-01"
|
|
}
|
|
]
|
|
}
|
|
}'
|
|
```
|
|
|
|
## 流程字段说明
|
|
|
|
### 申请信息
|
|
|
|
| 字段名 | 类型 | 必填 | 说明 |
|
|
|---|---|---|---|
|
|
| 申请人 | Employee | 需确认 | 人员字段，通过 `dataOptions` 传值，建议使用工号。 |
|
|
| 申请部门 | Department | 需确认 | 部门字段，通过 `dataOptions` 传值，建议使用部门编号。 |
|
|
|
|
### 用车信息
|
|
|
|
| 字段名 | 类型 | 必填 | 说明 |
|
|
|---|---|---|---|
|
|
| 用车日期 | Date | 需确认 | 日期字符串。 |
|
|
| 用车事由 | TextArea | 需确认 | 用车原因说明。 |
|