新增唯一数据

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

描述

根据指定的字段在指定表单新增一条数据，当指定字段的值已经存在的时候，不进行新增，并返回已经存在的数据的ID

使用须知

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

• POST请求头

{"Authorization": "Bearer YOUR_APIKEY"}

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

接口URL

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

名词解释

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

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

请求参数

参数名	示例值	参数类型	是否必填	参数描述
data		Object	是	数据内容
is_start_workflow	false	Boolean	否	用来控制是否触发流程，默认不触发流程
is_start_event	true	Boolean	否	是否触发事件（模块事件/_form事件/数据助手）
operator	5466ebe918a90c64c26fcc67	String	否	操作人id，默认使用应用所有者的id
unique	单行文本	Array	是	唯一字段，可以是多个字段 必须是以下类型控件：单行文本、多行文本，数字，日期, 下拉框，成员单选，部门单选，单选按钮组

请求示例

{
    "data": {
        "单行文本": "张三",
        "多行文本": "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"
            }
        ],
        "子表单": [
            {
                "单行文本_子表单": "张三"
            },
            {
                "单行文本_子表单": "张三"
            }
        ],
        "成员单选": "5577ebc4504e8e77036d2a09",
        "成员多选": [
            "5577ebc4504e8e77036d2a09"
        ],
        "部门单选": "51d1177b964603db9e60a962",
        "部门多选": [
            "51d1177b964603db9e60a962"
        ]
    },
    "is_start_workflow": false,
    "is_start_event": true,
    "operator": "5466ebe918a90c64c26fcc67",
    "unique": [
        "单行文本"
    ]
}

响应参数

参数名	示例值	参数类型	参数描述
data	-	Object	返回数据内容
data.status	1	Number	状态 0失败，1成功
data.data_id	5cea2fc4e60659a5fb48cf9d	Array	成功时返回成功数据的id，失败时返回已存在数据的id
data.error_code	0	Number	错误码，成功时 0
data.error_message	ok	String	错误详情，成功时ok

响应数据样例

{
    "data": {
        "status": 1,
        "data_id": [
            "5cea2fc4e60659a5fb48cf9d"
        ],
        "error_code": 0,
        "error_message": "ok"
    }
}