发起流程

• 描述
• 使用须知
• 接口URL
• 名词解释
• 请求参数
• 请求示例
• 响应参数
• 响应数据样例

描述

在指定流程表单中发起一个流程 另外，系统字段 和 以下所列举的字段不支持添加和修改数据：

• 分割线
• 关联数据、关联查询

使用须知

开发前，请仔细阅读开发指南。

• POST请求头

{"Authorization": "Bearer YOUR_APIKEY"}

• YOUR_APIKEY请阅读开发指南了解。

接口URL

POST - /openapi/v1/app/{app_id}/entry/{entry_id}/flow_start

名词解释

名称	说明
app_id	应用ID
entry_id	该应用内的表单ID

app_id+entry_id表示全局唯一的表单标识，前往开发平台中的API文档进行查看。

请求参数

参数名	示例值	参数类型	是否必填	参数描述
values		Object	是	数据内容
requiredValidation	false	Boolean	否	是否验证字段必填项，默认false
flowCreator	5043f034699af3458734f91c	String	否	发起人

请求示例

{
    "values": {
        "单行文本": "张三",
        "多行文本": "webapi",
        "数字": 8,
        "日期时间": "2019-01-01 11:11:11",
        "单选按钮组": "一年级",
        "复选框组": [
            "选项1",
            "选项2"
        ],
        "下拉框": "女",
        "下拉复选框": [
            "选项1",
            "选项2"
        ],
        "地址": {
            "province": "湖南省",
            "city": "长沙市",
            "district": "芙蓉区",
            "detail": "韶山北路"
        },
        "定位": {
            "province": "湖南省",
            "city": "长沙市",
            "district": "芙蓉区",
            "detail": "韶山北路",
            "lnglatXY": [
                112.99627,
                28.19393
            ]
        },
        "图片": [
            {
                "name": "123.jpg",
                "url": "https://www.xxxxx.com/FvNMG4BF9LEsbSv3HaO5gA9U0rQz"
            }
        ],
        "子表单": [
            {
                "单行文本_子表单": "张三",
                "复选框组_子表单": [
                    "选项1",
                    "选项2"
                ],
                "图片_子表单": [
                    {
                        "name": "123.jpg",
                        "url": "https://www.xxxxx.com/FvNMG4BF9LEsbSv3HaO5gA9U0rQz"
                    }
                ]
            },
            {
                "单行文本_子表单": "张三"
            }
        ],
        "成员单选": "5577ebc4504e8e77036d2a09",
        "成员多选": [
            "5577ebc4504e8e77036d2a09"
        ],
        "部门单选": "51d1177b964603db9e60a962",
        "部门多选": [
            "51d1177b964603db9e60a962"
        ]
    },
    "requiredValidation": false,
    "flowCreator": "5d66359813f33ef2e45916f2"
}

响应参数

参数名	示例值	参数类型	参数描述
dataId	517a285739f4f6f0d33d01f9	String	数据id

响应数据样例

{
    "dataId": "517a285739f4f6f0d33d01f9"
}