新建單筆資料 API調試

簡介

API 簡介

透過新建單筆資料 API，可以向指定的表單中新增單筆資料。

附註：

使用 API 新增資料時，會觸發的事件有新資料送出通知、彙總表計算&校驗、資料操作日誌、資料量統計。也可以透過請求參數來控制是否發起流程。但是不會觸發重複值校驗、必填校驗。

另外，系統欄位和以下所列舉的欄位不支援新增和修改資料：

API調用

在指定表單中新增一筆資料。

請求地址：https://api.jodoo.com/api/v5/app/entry/data/create

請求頻率：20 次/秒

請求方式：POST

請求參數：

請求範例：

{
    "app_id": "59264073a2a60c0c08e20bfb",
    "entry_id": "59264073a2a60c0c08e20bfd",
    "transaction_id": "87cd7d71-c6df-4281-9927-469094395677",   //事務ID
    "data": {
        "_widget_1432728651402": { // 單行文字
            "value": "Jodoo"
        },
        "_widget_1432728651403": { // 數字
            "value": 100
        },
        "_widget_1432728651404": { // 多行文字
            "value": "Jodoo 是一個強大易用的應用搭建工具，\n可以快速把你的想法變成應用"
        },
        "_widget_1432728651405": { // 單選、下拉單選
            "value": "選項一"
        },
        "_widget_1432728651406": { // 複選、下拉複選框
            "value": [
                "選項一","選項二","選項三"
            ]
        },
        "_widget_1432728651407": { // 日期時間
            "value": "2018-01-01T10:10:10.000Z"
        },       
        "_widget_1528854613291": { // 子表單
            "value": [
                { // 子表單子記錄結構跟主表一致
                    "_widget_1528854614409": {
                        "value": "子表單資料1"
                    },
                    "_widget_1528854615499": {
                        "value": 1001
                    }
                },
                {
                    "_widget_1528854614410": {
                        "value": "子表單資料2"
                    },
                    "_widget_1528854615419": {
                        "value": 1002
                    }
                }
            ]
        },
        "_widget_1652345009126": { //成員單選（成員的username）
            "value": "jian"
        },
        "_widget_1652345009143": { //成員多選（成員的username陣列）
            "value": [
                "jian",
                "dao"
            ]
        },
        "_widget_1652345009157": { //部門單選（部門的dept_no）
            "value": 12
        },
        "_widget_1652345009174": { //部門多選（部門的dept_no陣列）
            "value": [
                12,
                13
            ]
        },
        "_widget_1432728651408": { // 附件（文件key陣列）
            "value": ["6b559cf1-b16c-43bd-a211-8fa8fdeae2ef","6b559cf1-b16c-43bd-a211-646ab85da8cb"]
        },
        "_widget_1432728652567": { // 圖片（文件key陣列）
            "value": ["6b559cf1-b16c-43bd-a211-74389cd8ae76","6b559cf1-b16c-43bd-a211-564e56a65bd6"]
        },
        "_widget_1432728651408": { // 附件（文件key陣列）
            "value": ["6b559cf1-b16c-43bd-a211-8fa8fdeae2ef","6b559cf1-b16c-43bd-a211-646ab85da8cb"]
        },
        "_widget_1432728652567": { // 圖片（文件key陣列）
            "value": ["6b559cf1-b16c-43bd-a211-74389cd8ae76","6b559cf1-b16c-43bd-a211-564e56a65bd6"]
        }
    }
}

回應內容：

回應範例：

{
    "data": {
        "_id": "59e9a2fe283ffa7c11b1ddbf",  
        "appId": "59264073a2a60c0c08e20bfb",
        "entryId": "59264073a2a60c0c08e20bfd",
        "creator": {
            "name": "Jodoo",
            "username": "Jodoo",
            "status": 1,
            "type": 0,
            "departments": [1, 3],           
        },
        "updater": {
            "name": "Jodoo",
            "username": "Jodoo",
            "status": 1,
            "type": 0,
            "departments": [1, 3],
        },
        "createTime": "2017-10-20T22:41:51.430Z", // 建立時間
        "updateTime": "2017-10-20T11:12:15.293Z", // 修改時間
        "_widget_1432728651402": "Jodoo",  // 單行文字
        "_widget_1432728651403": 100, // 數字
        "_widget_1432728651404": "Jodoo是一個強大易用的應用搭建工具，可以快速把你的想法變成應用", // 多行文字
        "_widget_1432728651405": "選項一", // 單選、下拉單選
        "_widget_1432728651406": [ // 複選、下拉複選框
            "選項一、選項二、選項三"
        ],
        "_widget_1432728651407": "2018-01-01T10:10:10.000Z", // 日期時間
        "_widget_1432728651408": { // 選擇資料
            "id": "5b28effa49b561455dfda91e",
            "key": "Jodoo"
        },
        "_widget_1432728651409": [ // 圖片
            {
                "name": "image.jpg",
                "size": 262144,
                "mime": "image/jpeg",
                "url": "https://files.jodoo.com/lepxaifzcapghupffcaswikmhnyp"
            }
        ],
        "_widget_1432728651410": [ // 附件
            {
                "name": "產品說明文件.pdf",
                "size": 524288,
                "mime": "application/pdf",
                "url": "https://files.jodoo.com/bogrebbkdbkfsbuldnjujoenclle"
            }
        ],
        "_widget_1432728651411": { // 手寫簽名
            "name": "image.png",
            "size": 262144,
            "mime": "image/png",
            "url": "https://files.jodoo.com/sxbikbrchwlylrgqwyfkjbjmuncp"      
        },
        "_widget_1432728651414": { // 成員單選
            "name": "Jodoo",
            "username": "Jodoo",
            "status": 1,
            "type": 0,
            "departments": [1, 3],
        },
        "_widget_1432728651415": [ // 成員多選
            {
                "name": "Jodoo",
                "username": "Jodoo",
                "status": 1,
                "type": 0,
                "departments": [1, 3],
            }
        ],
        "_widget_1432728651416": {  // 部門單選
            "name": "經理部",
            "dept_no": 1,
            "type": 0,
            "parent_no": 2,
            "status": 1,
        },
        "_widget_1432728651417": [ // 部門多選
            {
                "name": "經理部",
                "dept_no": 1,
                "type": 0,
                "parent_no": 2,
                "status": 1,
            }
        ],
        "_widget_1432728651408": [ // 子表單
            {
                // ... 同前面
            }
        ],
        "wx_open_id": "wx98fb14481b3ab5a3",
        "wx_nickname": "jodoo",
        "wx_gender": "男"
    }
}

注意事項

如果請求中指定了 data_creator，則關聯觸發的以下成員也會被記錄為 data_creator，如下所示：