簡介
API 簡介
透過新建單筆資料 API，可以向指定的表單中新增單筆資料。
附註：
使用 API 新增資料時，會觸發的事件有新資料送出通知、彙總表計算&校驗、資料操作日誌、資料量統計。也可以透過請求參數來控制是否發起流程。但是不會觸發重複值校驗、必填校驗。
另外，系統欄位和以下所列舉的欄位不支援新增和修改資料：
分割線
手寫簽名
選擇資料、查詢
流水號（送出後系統生成）
API調用
在指定表單中新增一筆資料。
請求頻率：20 次/秒
請求方式：POST
請求參數：
參數 | 類型 | 必需 | 說明 | 預設 |
app_id | String | 是 | 應用 ID | / |
entry_id | String | 是 | 表單 ID | / |
data | JSON | 是 | 資料內容 | / |
is_start_workflow | Bool | 否 | 是否發起流程（僅流程表單有效） | false |
is_start_trigger | Bool | 否 | 是否觸發智慧助手 | false |
transaction_id | String | 否 | 事務ID；transaction_id 用於綁定一批上傳的文件，若資料中包含附件或圖片控件，則 transaction_id 必須與“取得文件上傳憑證和上傳地址 API”中的 transaction_id 參數相同。 | / |
請求範例：
{ "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 | JSON | 返回送出後的完整資料，內容同查詢單筆資料 API |
回應範例：
{ "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，如下所示：
智慧助手執行人
流程發起人