表單和資料 API

API類型

API文件

API說明

表單API

表單API

可以取得指定表單的欄位/欄位資訊。

資料API

查詢單筆資料API

按照指定資料 ID 取得表單中的資料。

資料API

查詢多條資料API

該API的返回資料，始終按照資料 ID 正序排列。

資料API

新建單筆資料API

按照指定資料 ID 取得表單中的資料。

資料API

新建多條資料API

建立多條資料API最多支援 100 條資料。

資料API

修改單筆資料API

按照指定資料 ID 修改表單中的資料。

資料API

修改多條資料API

批次更新多條資料，最多支援修改 100 條資料。

資料API

刪除單筆資料API

按照指定資料 ID 從表單中刪除資料。

欄位名稱

欄位類型

資料類型

資料樣例

備註

單行文字

text

String

“張三”

/

多行文字

textarea

String

“我愛 Jodoo”

/

流水號

sn

String

“00001”

/

數字

number

Number

10

/

日期時間

datetime

String

“2018-01-01T10:10:10.000Z”

UTC 統一時間格式的字串

單選

radiogroup

String

“一年級”

複選

checkboxgroup

Array

[“選項1”,“選項2”]

下拉單選

combo

String

“女”

下拉複選框

combocheck

Array

[“選項1”,“選項2”]

圖片

image

Array

[

{

"name": "image1.png",

"size": 262144,

"mime": "image/png",

"url": "https://files.jodoo.com/cqbrmcwhxm"

}, {

"name": "image2.png",

"size": 262100,

"mime": "image/png",

"url": "https://files.jodoo.com/cqbrywmwh"

}

]

資料中包含的 url 為圖片連結，15 天內有效

附件

upload

Array

[

{

"name": "產品說明文件.pdf",

"size": 524288,

"mime": "application/pdf",

"url": "https://files.jodoo.com/ojiwvfeyt"

}， [

{

"name": "開發架構文件.pdf",

"size": 524288,

"mime": "application/pdf",

"url": "https://files.jodoo.com/mst"

}

]

資料中包含的 url 為附件連結，15 天內有效

子表單

subform

Array

[

{

"_id":"5b237548b22ab14884086cc0",

"_widget_1529400746031"：......

},

{

"_id":"5b237548b22ab14884086cc1",

"_widget_1529400746031"：......

}

]

_id 為子表單資料 ID，由服務端生成

關聯資料

linkdata

JSON

{

"id": "5b237548b22ab14884086cc0",

}

id 表示所關聯資料的 ID

手寫簽名

signature

JSON

{

"name": "signature_1238921857.png",

"size": 1024,

"mime": "image/png",

"url": "https://files.jodoo.com/ojiwsdf"

}

資料中包含的 url 為手寫簽名的圖片連結，15 天內有效

成員單選

user

JSON

{

"name": "Jodoo",

"username": "Jodoo",

"status": 1,

"type": 0,

"departments": [1, 3],

}

成員資訊中 username 表示通訊錄的成員編號（企業內唯一），name 表示使用者暱稱

status 對應的邏輯:

-1 離職

0 未加入

1 已加入

成員多選

usergroup

Array

[

{

"name": "Jodoo",

"username": "Jodoo",

"status": 1,

"type": 0,

"departments": [1, 3],

}

]

status 對應的邏輯:

-1 離職

0 未加入

1 已加入

部門單選

dept

JSON

{

"name": "經理部",

"dept_no": 1,

"type": 0,

"parent_no": 2,

"status": 1,

}

部門資訊中 dept_no 表示通訊錄的部門編號（企業內唯一），name 表示部門名稱

部門多選

deptgroup

Array

[

{

"name": "經理部",

"dept_no": 1,

"type": 0,

"parent_no": 2,

"status": 1,

}

]

/

系統欄位

欄位名

資料類型

資料樣例

備註

應用Id

appId

String

“5b237267b22ab14884086c49”

全局唯一性ID

表單Id

entryId

String

“5b237267b22ab14884086cc9”

appId+entryId保證表單ID的唯一性

資料ID

_id

String

“5b237267b22ab14884086c50”

資料全局唯一性ID

連結參數

ext

String

“廣州”

-

送出時間

createTime

String

“2018-01-01T10:10:10.000Z”

-

送出人

creator

JSON

{

"name": "Jodoo",

"username": "Jodoo",

"status": 1,

"type": 0,

"departments": [1, 3],

}

status 對應的邏輯:

-1 離職

0 未加入

1 已加入

修改時間

updateTime

String

“2018-01-01T10:10:10.000Z”

-

修改人

updater

JSON

{

"name": "Jodoo",

"username": "Jodoo",

"status": 1,

"type": 0,

"departments": [1, 3],

"integrate_id": "Jodoo"

}

status 對應的邏輯:

-1 離職

0 未加入

1 已加入

刪除人

deleter

JSON

{

"name": "Jodoo",

"username": "Jodoon",

"status": 1,

"type": 0,

"departments": [1, 3],

"integrate_id": "Jodoo"

}

status 對應的邏輯:

-1 離職

0 未加入

1 已加入

流程狀態

*僅流程表單

flowState

0

該欄位僅流程表單支援。2表示流程手動結束；1表示流程流轉完成；0表示流程進行中。

-

支援格式

範例

ISO日期格式

毫秒時間戳

rfc 3339

yyyy-MM-dd HH:mm:ss

yyyy-MM-dd

功能

create

update

delete

batch_create

batch_update

資料工廠延時計算

觸發

觸發

觸發

觸發

觸發

資料訊息推播

觸發

觸發

不觸發

觸發

觸發

觸發彙總表

觸發

觸發

觸發

觸發

觸發

資料操作日誌

記錄

記錄

記錄

記錄

記錄

webhook 資料推播

不觸發

不觸發

不觸發

不觸發

不觸發

智慧助手

可觸發

可觸發

可觸發

不觸發

不觸發

重複值校驗

不校驗

不校驗

-

不校驗

不校驗

表單校驗

不校驗

不校驗

-

不校驗

不校驗

必填校驗

不校驗

不校驗

-

不校驗

不校驗

流程節點校驗

不校驗

不校驗

-

不校驗

不校驗

觸發流程

可觸發

不觸發

-

可觸發

不觸發

彙總表校驗

校驗

校驗

觸發

不校驗

不校驗

欄位聯動、公式

不觸發

不觸發

-

不觸發

不觸發

表單推播通知

觸發

觸發

-

不觸發

不觸發