2.5 KiB
2.5 KiB
创建用车审批流程实例接口
接口说明
该接口用于外部系统向 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
请求示例
最小请求
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 | 需确认 | 用车原因说明。 |