Files
fanwei-e10-api-doc/examples/sample-output-api-doc.md
T
2026-06-01 14:37:23 +08:00

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 需确认 用车原因说明。