支點(預覽)
Fulcrum 是一個以現場為先的解決方案,讓 GIS 專家與非 GIS 團隊成員都能輕鬆捕捉並分享地理空間資料。 此連接器可與 Fulcrum 整合,管理現場資料、照片、影片等。
此連接器適用於以下產品和區域:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | 進階 | 除以下部分外,所有Power Automate區域: - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government regions - Azure中國地區 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除以下部分外,所有Power Apps區域 - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate | 進階 | 除以下部分外,所有Power Automate區域: - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | Fulcrum 支援 |
| URL | https://www.fulcrumapp.com/support |
| support@fulcrumapp.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 空間網絡公司 |
| 網站 | https://www.fulcrumapp.com |
| 隱私策略 | https://www.fulcrumapp.com/privacy |
| 類別 | 生產力;資料 |
支點
Fulcrum 是一個以現場為先的解決方案,讓 GIS 專家與非 GIS 團隊成員都能輕鬆捕捉並分享地理空間資料。 此連接器可與 Fulcrum 整合,管理現場資料、照片、影片等。
Publisher
支點
先決條件
- 啟用 API 存取的 Active Fulcrum 訂閱
支援的作業
觸發器
當支點事件發生時
當 Fulcrum 資源被建立、更新或刪除時觸發。 支援紀錄、表單、選擇清單及分類集的事件。 在你的 Fulcrum 組織中設定 webhook,指定要監控哪些事件。
行動
取得附件元資料清單
檢索附件清單。
買個附件
為單一附件擷取元資料。
取得音訊元資料清單
取得音訊檔案清單的元資料。
取得原始音訊檔
下載原始音訊檔案。
取得照片元資料清單
取得照片清單的元資料。
取得原始照片檔案
下載原始照片檔案。
取得照片元資料
取得單一照片的元資料。
提出查詢 POST 請求
使用 HTTP POST 執行查詢 API 請求。 提供類似 SQL 的查詢,以查詢你組織的資料。
取得紀錄清單
取得組織內可依表單、專案、變更集、邊界框及日期範圍等維度篩選的紀錄清單。
建立記錄
使用所提供的表單值、位置資訊及相關元資料,建立指定表單的新紀錄。
刪除記錄
從你的組織刪除紀錄。
取得記錄
透過 ID 檢索特定紀錄的詳細資訊。 這包括所有表單欄位的值、位置資料、時間戳記及相關的元資料。
部分更新紀錄
更新現有紀錄中的特定欄位,無需完整記錄物件即可。 只有請求主體中包含的欄位會被修改,其他欄位則保持不變。 這對於更新個別欄位值或元資料非常有用。
更新記錄
用所提供的記錄物件更新紀錄。 記錄物件預期是該紀錄的完整表示。 未包含的欄位視為空。
取得紀錄的歷史
取得紀錄的完整版本歷史。
建立報表
為特定紀錄產生新報告,可選擇使用報告範本。
取得報告檔案
下載產生的 PDF 報告檔案。
取得簽名元資料清單
取得簽名清單的元資料。
取得簽名元資料
取得單一簽章的元資料。
取得簽名原始檔案
下載原始簽名檔。
取得草圖元資料清單
取回草圖清單的元資料。
取得草圖原始檔案
下載原始草圖檔案。
取得草圖元資料
為單一草圖擷取元資料。
取得影片元資料清單
取得影片清單的元資料。
取得原始影片檔案
下載原始影片檔案。
取得憑證
要使用 Fulcrum 連接器,你需要一個 Fulcrum API 令牌:
- 請登入您的 Fulcrum 帳號 https://web.fulcrumapp.com
- 前往設定 > API
- 產生新的 API 代幣或使用現有的
- 複製權杖並在建立連線時使用
使用者入門
建立新連線並在提示時輸入你的 Fulcrum API 令牌。
自訂主機網址
預設情況下,連接器使用生產版 Fulcrum API 於 api.fulcrumapp.com。 其他地區,你可以在建立連線時指定不同的主機網址。
區域終點:
- United States(預設):
api.fulcrumapp.com - 加拿大:
api.fulcrumapp-ca.com - 澳洲:
api.fulcrumapp-au.com - 歐洲:
api.fulcrumapp-eu.com
賽制: 只輸入主機名稱,無需協定或路徑。 連接器會自動使用 HTTPS 和正確的 API 路徑。
疑難排解:
- 確保你的自訂主機能從你的網路存取
- 確認主機名稱正確(沒有打錯字)
- 確認你的 API 憑證是否適用於指定的主機
已知問題和限制
- 費率限制會根據你的 Fulcrum 方案而定
部署指示
請使用 these instructions 在Power Automate和Power Apps中以自訂連接器Microsoft部署。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | 說明 | 必要 |
|---|---|---|---|
| API 令牌 | 安全字串 | 你的 Fulcrum API 認證令牌 | 對 |
| 主機 URL | 字串 | 你 Fulcrum 實例的 API 主機 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 刪除記錄 |
從你的組織刪除紀錄。 |
| 取得原始影片檔案 |
下載原始影片檔案。 |
| 取得原始照片檔案 |
下載原始照片檔案。 |
| 取得原始音訊檔 |
下載原始音訊檔案。 |
| 取得報告檔案 |
下載產生的 PDF 報告檔案。 |
| 取得影片元資料清單 |
取得影片清單的元資料。 |
| 取得照片元資料 |
取得單一照片的元資料。 |
| 取得照片元資料清單 |
取得照片清單的元資料。 |
| 取得簽名元資料 |
取得單一簽章的元資料。 |
| 取得簽名元資料清單 |
取得簽名清單的元資料。 |
| 取得簽名原始檔案 |
下載原始簽名檔。 |
| 取得紀錄清單 |
取得組織內可依表單、專案、變更集、邊界框及日期範圍等維度篩選的紀錄清單。 |
| 取得紀錄的歷史 |
取得紀錄的完整版本歷史。 |
| 取得草圖元資料 |
為單一草圖擷取元資料。 |
| 取得草圖元資料清單 |
取回草圖清單的元資料。 |
| 取得草圖原始檔案 |
下載原始草圖檔案。 |
| 取得記錄 |
透過 ID 檢索特定紀錄的詳細資訊。 這包括所有表單欄位的值、位置資料、時間戳記及相關的元資料。 |
| 取得附件元資料清單 |
檢索附件清單。 |
| 取得音訊元資料清單 |
取得音訊檔案清單的元資料。 |
| 建立報表 |
為特定紀錄產生新報告,可選擇使用報告範本。 |
| 建立記錄 |
使用所提供的表單值、位置資訊及相關元資料,建立指定表單的新紀錄。 |
| 提出查詢 POST 請求 |
使用 HTTP POST 執行查詢 API 請求。 提供類似 SQL 的查詢,以查詢你組織的資料。 |
| 更新記錄 |
用所提供的記錄物件更新紀錄。 記錄物件預期是該紀錄的完整表示。 未包含的欄位視為空。 |
| 買個附件 |
為單一附件擷取元資料。 |
| 部分更新紀錄 |
更新現有紀錄中的特定欄位,無需完整記錄物件即可。 只有請求主體中包含的欄位會被修改,其他欄位則保持不變。 這對於更新個別欄位值或元資料非常有用。 |
刪除記錄
從你的組織刪除紀錄。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄標識碼
|
record_id | True | string |
刪除記錄的唯一識別碼。 |
|
X 跳過工作流程
|
X-SkipWorkflows | boolean |
跳過所有應用程式的工作流程 |
|
|
X 跳過網鉤
|
X-SkipWebhooks | boolean |
跳過所有應用程式的 webhook |
傳回
取得原始影片檔案
取得原始照片檔案
取得原始音訊檔
取得報告檔案
取得影片元資料清單
取得影片清單的元資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄標識碼
|
record_id | string |
影片所關聯的紀錄識別碼。 |
|
|
表單識別碼
|
form_id | string |
影片所關聯的表單識別碼。 留空的話,所有影片都會被查詢。 |
|
|
最新第一
|
newest_first | boolean |
若有影片,將依日期排序updated_at。 |
|
|
已處理
|
processed | boolean |
篩選出完全處理過的影片。 |
|
|
已儲存
|
stored | boolean |
篩選已完全儲存的影片。 |
|
|
上傳
|
uploaded | boolean |
篩選已完全上傳的影片。 |
|
|
頁面
|
page | integer |
要求的頁碼。 |
|
|
每頁
|
per_page | integer |
每頁需歸還的項目數量。 |
傳回
取得照片元資料
取得單一照片的元資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
照片身份證件
|
photo_id | True | string |
照片的唯一識別碼。 |
傳回
取得照片元資料清單
取得照片清單的元資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄標識碼
|
record_id | string |
照片所關聯的紀錄識別碼。 |
|
|
表單識別碼
|
form_id | string |
照片所關聯的表格識別碼。 留空的話,查詢會對你所有的照片產生查詢。 |
|
|
最新第一
|
newest_first | boolean |
如有照片,將依日期排序updated_at。 |
|
|
已處理
|
processed | boolean |
篩選已完全沖洗過的照片。 |
|
|
已儲存
|
stored | boolean |
篩選已完全儲存的照片。 |
|
|
上傳
|
uploaded | boolean |
篩選已完全上傳的照片。 |
|
|
頁面
|
page | integer |
要求的頁碼。 |
|
|
每頁
|
per_page | integer |
每頁需歸還的項目數量。 |
傳回
取得簽名元資料
取得單一簽章的元資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
簽名 ID
|
signature_id | True | string |
簽名的唯一識別碼。 |
傳回
取得簽名元資料清單
取得簽名清單的元資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄標識碼
|
record_id | string |
照片所關聯的紀錄識別碼。 |
|
|
表單識別碼
|
form_id | string |
照片所關聯的表格識別碼。 留空的話,查詢會對你所有的照片產生查詢。 |
|
|
最新第一
|
newest_first | boolean |
如有照片,將依日期排序updated_at。 |
|
|
已處理
|
processed | boolean |
篩選已完全處理的簽名。 |
|
|
已儲存
|
stored | boolean |
篩選已完全儲存的簽名。 |
|
|
上傳
|
uploaded | boolean |
篩選已完全上傳的簽名。 |
|
|
頁面
|
page | integer |
要求的頁碼。 |
|
|
每頁
|
per_page | integer |
每頁需歸還的項目數量。 |
傳回
取得簽名原始檔案
取得紀錄清單
取得組織內可依表單、專案、變更集、邊界框及日期範圍等維度篩選的紀錄清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
最新第一
|
newest_first | boolean |
如有紀錄,將依日期排序updated_at。 |
|
|
邊界盒
|
bounding_box | string |
請求的紀錄裝訂盒。 格式應該是:緯度、長度、長度、長度(底部、左側、頂部、右側)。 |
|
|
變更集識別碼
|
changeset_id | string |
與該紀錄相關的變更集 ID。 |
|
|
表單識別碼
|
form_id | string |
該紀錄所關聯的表單的ID。 留空會查詢你所有的紀錄。 |
|
|
專案編號
|
project_id | string |
該唱片所關聯的專案ID。 留空會查詢你所有的紀錄。 |
|
|
先前建立的客戶端
|
client_created_before | date-time |
只回傳客戶端(裝置)在指定時間前建立的紀錄。 |
|
|
客戶端自此建立
|
client_created_since | date-time |
只回傳客戶端(裝置)在指定時間後建立的紀錄。 |
|
|
用戶端先前更新
|
client_updated_before | date-time |
只回傳客戶端(裝置)在指定時間前更新過的紀錄。 |
|
|
用戶端已更新
|
client_updated_since | date-time |
只回傳客戶端(裝置)在指定時間後更新的紀錄。 |
|
|
建立時間之前
|
created_before | date-time |
只回傳在指定時間前在伺服器上建立的紀錄。 |
|
|
自此創作
|
created_since | date-time |
只回傳在指定時間後在伺服器上建立的紀錄。 |
|
|
更新日期
|
updated_before | date-time |
只回傳在指定時間前已更新(伺服器上)的紀錄。 |
|
|
更新時間
|
updated_since | date-time |
只回傳在指定時間後(伺服器上)已更新的紀錄。 |
|
|
頁面
|
page | integer |
所要求的頁碼 |
|
|
每頁
|
per_page | integer |
每頁項目數 |
傳回
取得紀錄的歷史
取得紀錄的完整版本歷史。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄標識碼
|
record_id | True | string |
你想取得歷史紀錄的唯一識別碼。 |
傳回
取得草圖元資料
取得草圖元資料清單
取回草圖清單的元資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄標識碼
|
record_id | string |
該速寫所關聯的紀錄的識別碼。 |
|
|
表單識別碼
|
form_id | string |
該草圖所關聯的形態識別碼。 留空這個欄位會讓你對所有草圖產生查詢。 |
|
|
最新第一
|
newest_first | boolean |
若有草圖,將依日期排序updated_at。 |
|
|
已處理
|
processed | boolean |
草圖已經完全處理完畢。 |
|
|
已儲存
|
stored | boolean |
Sketch 已經完全儲存。 |
|
|
上傳
|
uploaded | boolean |
草圖已完全上傳。 |
|
|
頁面
|
page | integer |
所要求的頁碼 |
|
|
每頁
|
per_page | integer |
每頁項目數 |
傳回
取得草圖原始檔案
取得記錄
透過 ID 檢索特定紀錄的詳細資訊。 這包括所有表單欄位的值、位置資料、時間戳記及相關的元資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄標識碼
|
record_id | True | string |
要取回紀錄的唯一識別碼。 |
傳回
取得附件元資料清單
檢索附件清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄標識碼
|
record_id | string |
該附件所關聯的紀錄的 ID。 在列出紀錄附件時,這是必須的。 |
|
|
表單識別碼
|
form_id | string |
該附件所關聯的 ID。 這個參數會讓你在表單中取得所有參考檔案,但不會包含表單中所有記錄附件 |
|
|
業主類型
|
owner_type | string |
查詢的附件類型。 必須是其中之一 |
|
|
排序
|
sort | string |
篩選結果的欄位。 |
|
|
排序方向
|
sort_direction | string |
排序方向(上升、下降)。 預設是上升。 |
傳回
取得音訊元資料清單
取得音訊檔案清單的元資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄標識碼
|
record_id | string |
音訊檔案所關聯的紀錄的 ID。 |
|
|
表單識別碼
|
form_id | string |
音訊檔案所關聯的表單的 ID。 留空的話,會對你所有的音訊檔案進行查詢。 |
|
|
最新第一
|
newest_first | boolean |
若有,音訊檔案會依日期排序updated_at。 |
|
|
已處理
|
processed | boolean |
過濾已完全處理的音訊檔案。 |
|
|
已儲存
|
stored | boolean |
過濾已完全儲存的音訊檔案。 |
|
|
上傳
|
uploaded | boolean |
過濾已完全上傳的音訊檔案。 |
|
|
頁面
|
page | integer |
要求的頁碼。 |
|
|
每頁
|
per_page | integer |
每頁需歸還的項目數量。 |
傳回
建立報表
為特定紀錄產生新報告,可選擇使用報告範本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
record_id
|
record_id | True | uuid |
產生報告的紀錄 ID |
|
template_id
|
template_id | uuid |
報告範本的 ID(可選) |
傳回
建立記錄
使用所提供的表單值、位置資訊及相關元資料,建立指定表單的新紀錄。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
內容類型
|
Content-Type | string |
內容類型 |
|
|
X 跳過工作流程
|
X-SkipWorkflows | boolean |
跳過所有應用程式的工作流程 |
|
|
X 跳過網鉤
|
X-SkipWebhooks | boolean |
跳過所有應用程式的 webhook |
|
|
assigned_to_id
|
assigned_to_id | string |
指派至此紀錄的使用者識別碼 |
|
|
form_id
|
form_id | True | string |
本紀錄所屬形式的識別碼 |
|
form_values
|
form_values | object |
欄位值以欄位鍵鍵 |
|
|
座標
|
coordinates | True |
幾何座標。 格式依類型而異:點使用[經度、緯度],線條使用位置陣列,多邊形使用線性環陣列(第一個為外部,其餘為孔),多重*類型使用其座標結構的陣列。 |
|
|
型別
|
type | True | string |
GeoJSON 幾何類型 |
|
緯度
|
latitude | number |
緯度座標 |
|
|
經度
|
longitude | number |
經度座標 |
|
|
project_id
|
project_id | string |
專案的ID |
|
|
狀態
|
status | string |
唱片狀態 |
傳回
提出查詢 POST 請求
使用 HTTP POST 執行查詢 API 請求。 提供類似 SQL 的查詢,以查詢你組織的資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
頁面
|
page | integer |
要求的頁碼。 |
|
|
每頁
|
per_page | integer |
每頁需歸還的項目數量。 |
|
|
format
|
format | string |
回應格式 |
|
|
q
|
q | True | string |
SQL 查詢以執行 |
|
表格名稱
|
table_name | string |
查詢表名稱 |
更新記錄
用所提供的記錄物件更新紀錄。 記錄物件預期是該紀錄的完整表示。 未包含的欄位視為空。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
內容類型
|
Content-Type | string |
內容類型 |
|
|
記錄標識碼
|
record_id | True | string |
記錄識別碼 |
|
X 跳過工作流程
|
X-SkipWorkflows | boolean |
跳過所有應用程式的工作流程 |
|
|
X 跳過網鉤
|
X-SkipWebhooks | boolean |
跳過所有應用程式的 webhook |
|
|
assigned_to_id
|
assigned_to_id | string |
指派至此紀錄的使用者識別碼 |
|
|
form_id
|
form_id | True | string |
本紀錄所屬形式的識別碼 |
|
form_values
|
form_values | object |
欄位值以欄位鍵鍵 |
|
|
座標
|
coordinates | True |
幾何座標。 格式依類型而異:點使用[經度、緯度],線條使用位置陣列,多邊形使用線性環陣列(第一個為外部,其餘為孔),多重*類型使用其座標結構的陣列。 |
|
|
型別
|
type | True | string |
GeoJSON 幾何類型 |
|
緯度
|
latitude | number |
緯度座標 |
|
|
經度
|
longitude | number |
經度座標 |
|
|
project_id
|
project_id | string |
專案的ID |
|
|
狀態
|
status | string |
唱片狀態 |
買個附件
部分更新紀錄
更新現有紀錄中的特定欄位,無需完整記錄物件即可。 只有請求主體中包含的欄位會被修改,其他欄位則保持不變。 這對於更新個別欄位值或元資料非常有用。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
內容類型
|
Content-Type | string |
內容類型 |
|
|
記錄標識碼
|
record_id | True | string |
記錄識別碼 |
|
X 跳過工作流程
|
X-SkipWorkflows | boolean |
跳過所有應用程式的工作流程 |
|
|
X 跳過網鉤
|
X-SkipWebhooks | boolean |
跳過所有應用程式的 webhook |
|
|
assigned_to_id
|
assigned_to_id | string |
指派至此紀錄的使用者識別碼 |
|
|
form_values
|
form_values | object |
欄位值以欄位鍵鍵 |
|
|
座標
|
coordinates | True |
幾何座標。 格式依類型而異:點使用[經度、緯度],線條使用位置陣列,多邊形使用線性環陣列(第一個為外部,其餘為孔),多重*類型使用其座標結構的陣列。 |
|
|
型別
|
type | True | string |
GeoJSON 幾何類型 |
|
緯度
|
latitude | number |
緯度座標 |
|
|
經度
|
longitude | number |
經度座標 |
|
|
project_id
|
project_id | string |
專案的ID |
|
|
狀態
|
status | string |
唱片狀態 |
傳回
觸發程序
| 當支點事件發生時 |
當 Fulcrum 資源被建立、更新或刪除時觸發。 支援紀錄、表單、選擇清單及分類集的事件。 在你的 Fulcrum 組織中設定 webhook,指定要監控哪些事件。 |
當支點事件發生時
當 Fulcrum 資源被建立、更新或刪除時觸發。 支援紀錄、表單、選擇清單及分類集的事件。 在你的 Fulcrum 組織中設定 webhook,指定要監控哪些事件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
內容類型
|
Content-Type | string |
內容類型 |
|
|
活動中
|
active | boolean |
是否啟用了 webhook |
|
|
Webhook 名稱
|
name | True | string |
webhook 的顯示名稱 |
|
run_for_bulk_actions
|
run_for_bulk_actions | boolean |
是否執行 webhook 用於批量記錄動作 |
傳回
Fulcrum 的 Webhook 事件有效載荷
定義
Attachment
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
attached_to_id
|
attached_to_id | string |
此附件所附的資源識別碼 |
|
attached_to_type
|
attached_to_type | string |
這個附件所附著的資源類型 |
|
全
|
complete | boolean |
附件上傳是否完整 |
|
file_size
|
file_size | integer |
附件檔案大小(位元組) |
|
id
|
id | string |
附件的唯一識別碼 |
|
名字
|
name | string |
附件的檔案名稱 |
|
業主
|
owners | array of object |
附件的擁有者參考資料列表 |
|
id
|
owners.id | string |
車主身分證 |
|
型別
|
owners.type | string |
擁有者類型(例如「記錄」或「表格」) |
|
狀態
|
status | string |
附件狀態 |
|
uploaded_at
|
uploaded_at | date-time |
上傳附件的時間戳記 |
|
URL
|
url | uri |
存取附件的網址 |
附件回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
附件
|
attachments | array of Attachment | |
|
總計
|
total | integer |
歸還附件總數 |
|
total_count
|
total_count | integer |
可用附件總數 |
音訊
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
access_key
|
access_key | string |
音訊資源的唯一識別碼 |
|
content_type
|
content_type | string |
音訊檔案的 MIME 類型 |
|
建立於
|
created_at | date-time |
音頻製作的時間戳記 |
|
創建者
|
created_by | string |
建立音訊使用者的顯示名稱 |
|
created_by_id
|
created_by_id | string |
創作者的 ID |
|
deleted_at
|
deleted_at | date-time |
刪除音訊的時間戳記 |
|
file_size
|
file_size | integer |
音訊檔案大小(位元組) |
|
form_id
|
form_id | string |
相關表單的識別碼 |
|
適中
|
medium | uri |
音訊中介版本的網址(若已處理) |
|
中繼資料
|
metadata | object |
音訊元資料(例如,時長、格式細節) |
|
原始
|
original | uri |
原始音訊檔案的網址(若已儲存) |
|
熟
|
processed | boolean |
音訊是否經過處理 |
|
record_id
|
record_id | string |
相關紀錄的識別碼 |
|
小
|
small | uri |
音訊小版本的網址(若已處理) |
|
狀態
|
status | string |
音訊處理狀態 |
|
儲存
|
stored | boolean |
是否已經儲存了音訊 |
|
曲目
|
track | uri |
存取音軌的網址(如有) |
|
updated_at
|
updated_at | date-time |
音訊最後更新的時間戳記 |
|
updated_by
|
updated_by | string |
顯示最後更新音訊的使用者名稱 |
|
updated_by_id
|
updated_by_id | string |
最後更新音訊的使用者身分證 |
|
已上傳
|
uploaded | boolean |
音訊是否已上傳 |
|
URL
|
url | uri |
存取音訊資源的網址 |
音頻回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
audio
|
audio | array of Audio | |
|
current_page
|
current_page | integer | |
|
per_page
|
per_page | integer | |
|
total_count
|
total_count | integer | |
|
total_pages
|
total_pages | integer |
審計地點
位置元資料於建立或更新時擷取。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
高度
|
altitude | double |
高度以公尺為單位。 |
|
horizontal_accuracy
|
horizontal_accuracy | double |
水平精度以公尺為單位。 |
|
緯度
|
latitude | double |
緯度座標。 |
|
經度
|
longitude | double |
經度座標。 |
Geometry
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
座標
|
coordinates |
幾何座標。 格式依類型而異:點使用[經度、緯度],線條使用位置陣列,多邊形使用線性環陣列(第一個為外部,其餘為孔),多重*類型使用其座標結構的陣列。 |
|
|
型別
|
type | string |
GeoJSON 幾何類型 |
相片
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
access_key
|
access_key | string |
照片的唯一識別碼 |
|
content_type
|
content_type | string |
照片的默劇類型 |
|
建立於
|
created_at | date-time |
照片製作時 |
|
創建者
|
created_by | string |
顯示創建該照片的使用者名稱 |
|
created_by_id
|
created_by_id | string |
創建該照片的使用者身分證 |
|
deleted_at
|
deleted_at | date-time |
照片被刪除時 |
|
EXIF
|
exif | object |
照片中的 EXIF 元資料 |
|
file_size
|
file_size | integer |
照片檔案大小(位元組) |
|
form_id
|
form_id | string |
相關表單的識別碼 |
|
大型
|
large | uri |
照片大版的網址 |
|
緯度
|
latitude | double |
拍攝地點的緯度座標 |
|
經度
|
longitude | double |
照片拍攝地點的經度座標 |
|
原始
|
original | uri |
照片原始版本的網址 |
|
熟
|
processed | boolean |
照片是否經過處理 |
|
record_id
|
record_id | string |
相關紀錄的識別碼 |
|
儲存
|
stored | boolean |
照片是否已被保存 |
|
縮圖
|
thumbnail | uri |
照片縮圖版本的網址 |
|
updated_at
|
updated_at | date-time |
照片最後更新時間 |
|
updated_by
|
updated_by | string |
顯示最後更新照片的使用者名稱 |
|
updated_by_id
|
updated_by_id | string |
最後更新照片的使用者身分證 |
|
已上傳
|
uploaded | boolean |
照片是否已被上傳 |
|
URL
|
url | uri |
此照片資源的 API URL |
照片回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
current_page
|
current_page | integer | |
|
per_page
|
per_page | integer | |
|
相片
|
photos | array of Photo | |
|
total_count
|
total_count | integer | |
|
total_pages
|
total_pages | integer |
Record
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
高度
|
altitude | number | |
|
assigned_to
|
assigned_to | string | |
|
assigned_to_id
|
assigned_to_id | string | |
|
client_created_at
|
client_created_at | date-time | |
|
client_updated_at
|
client_updated_at | date-time | |
|
課程
|
course | number | |
|
建立於
|
created_at | date-time | |
|
創建者
|
created_by | string | |
|
created_by_id
|
created_by_id | string | |
|
created_duration
|
created_duration | number | |
|
created_location
|
created_location | AuditLocation |
位置元資料於建立或更新時擷取。 |
|
edited_duration
|
edited_duration | number | |
|
form_id
|
form_id | string | |
|
form_values
|
form_values | object |
欄位值由欄位鍵值鍵入——值可依欄位類型為字串、物件或陣列 |
|
幾何
|
geometry | Geometry | |
|
horizontal_accuracy
|
horizontal_accuracy | number | |
|
id
|
id | string | |
|
緯度
|
latitude | number | |
|
經度
|
longitude | number | |
|
project_id
|
project_id | string | |
|
record_series_id
|
record_series_id | string | |
|
speed
|
speed | number | |
|
狀態
|
status | string | |
|
system_status
|
system_status | string | |
|
updated_at
|
updated_at | date-time | |
|
updated_by
|
updated_by | string | |
|
updated_by_id
|
updated_by_id | string | |
|
updated_duration
|
updated_duration | number | |
|
updated_location
|
updated_location | AuditLocation |
位置元資料於建立或更新時擷取。 |
|
版本
|
version | integer | |
|
vertical_accuracy
|
vertical_accuracy | number |
記錄歷史項目
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
高度
|
altitude | double |
以公尺為單位記錄位置高度 |
|
assigned_to
|
assigned_to | string |
指定使用者的顯示名稱 |
|
assigned_to_id
|
assigned_to_id | string |
指定使用者的識別碼 |
|
changeset_id
|
changeset_id | string |
變更集識別碼 |
|
client_created_at
|
client_created_at | date-time |
用戶端建立時間戳記 |
|
client_updated_at
|
client_updated_at | date-time |
用戶端更新時間戳記 |
|
課程
|
course | double |
學位課程/方向 |
|
建立於
|
created_at | date-time |
紀錄建立時間戳記 |
|
創建者
|
created_by | string |
顯示建立該紀錄的使用者名稱 |
|
created_by_id
|
created_by_id | string |
建立該紀錄的使用者識別碼 |
|
created_duration
|
created_duration | integer |
紀錄建立的時間(秒數) |
|
created_location
|
created_location | AuditLocation |
位置元資料於建立或更新時擷取。 |
|
edited_duration
|
edited_duration | integer |
總編輯時間以秒計 |
|
form_id
|
form_id | string |
表單 ID |
|
form_values
|
form_values | object |
表單欄位值(處理中) |
|
form_version
|
form_version | integer |
紀錄建立/更新時的表單版本 |
|
座標
|
geometry.coordinates | array of number | |
|
型別
|
geometry.type | string | |
|
history_change_type
|
history_change_type | string |
變更類型(c=create, u=update, d=delete) |
|
history_changed_by
|
history_changed_by | string |
使用者的顯示名稱 |
|
history_changed_by_id
|
history_changed_by_id | string |
更改使用者身分 |
|
history_created_at
|
history_created_at | date-time |
此歷史條目建立的時間戳記 |
|
history_id
|
history_id | string |
歷史條目識別碼 |
|
horizontal_accuracy
|
horizontal_accuracy | double |
水平精度(公尺) |
|
id
|
id | string |
記錄識別碼 |
|
緯度
|
latitude | double |
記錄位置緯度 |
|
經度
|
longitude | double |
記錄位置經度 |
|
project_id
|
project_id | string |
專案識別碼 |
|
record_key
|
record_key | string |
可選的記錄鍵 |
|
record_sequence
|
record_sequence | integer |
可選的記錄序號 |
|
序列
|
sequence | integer |
序號(使用基於序列分頁時) |
|
speed
|
speed | double |
紀錄建立時的速度(m/s |
|
狀態
|
status | string |
紀錄狀態 |
|
updated_at
|
updated_at | date-time |
記錄最後更新時間戳記 |
|
updated_by
|
updated_by | string |
最後更新紀錄的使用者顯示名稱 |
|
updated_by_id
|
updated_by_id | string |
最後更新紀錄的使用者識別碼 |
|
updated_duration
|
updated_duration | integer |
記錄更新持續時間(秒數) |
|
updated_location
|
updated_location | AuditLocation |
位置元資料於建立或更新時擷取。 |
|
版本
|
version | integer |
唱片版本號 |
|
vertical_accuracy
|
vertical_accuracy | double |
垂直精度(公尺) |
紀錄歷史回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
current_page
|
current_page | integer |
當前頁碼(使用分頁時) |
|
next_sequence
|
next_sequence | integer |
下一個序號(使用基於序列分頁時) |
|
per_page
|
per_page | integer |
每頁記錄數(使用分頁時) |
|
案卷
|
records | array of RecordHistoryItem | |
|
total_count
|
total_count | integer |
使用分頁時,記錄總數 |
|
total_pages
|
total_pages | integer |
頁數總數(使用分頁時) |
紀錄回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
current_page
|
current_page | integer | |
|
per_page
|
per_page | integer | |
|
案卷
|
records | array of Record | |
|
total_count
|
total_count | integer | |
|
total_pages
|
total_pages | integer |
報告回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
completed_at
|
report.completed_at | date-time |
報告產生完成的時間戳記 |
|
建立於
|
report.created_at | date-time |
報告建立的時間戳記 |
|
failed_at
|
report.failed_at | date-time |
報告產生失敗的時間戳記(成功則為空) |
|
id
|
report.id | uuid |
報告的唯一識別碼 |
|
record_id
|
report.record_id | uuid |
報告所產生的紀錄識別碼 |
|
started_at
|
report.started_at | date-time |
報表產生開始的時間戳 |
|
狀態
|
report.state | string |
報告現況 |
|
template_id
|
report.template_id | uuid |
用於產生報告的範本 ID |
|
updated_at
|
report.updated_at | date-time |
報告最後更新的時間戳 |
|
URL
|
report.url | uri |
下載產生報告的網址 |
Signature
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
access_key
|
access_key | string |
簽名的唯一識別碼 |
|
content_type
|
content_type | string |
簽名檔案的 MIME 類型 |
|
建立於
|
created_at | date-time |
簽章建立的時間戳記 |
|
創建者
|
created_by | string |
建立簽章的使用者顯示名稱 |
|
created_by_id
|
created_by_id | string |
建立簽名的使用者識別碼 |
|
deleted_at
|
deleted_at | date-time |
簽名被刪除的時間戳記 |
|
file_size
|
file_size | integer |
簽名檔大小(位元組) |
|
form_id
|
form_id | string |
相關表單的識別碼 |
|
大型
|
large | uri |
簽名大版本的網址 |
|
原始
|
original | uri |
原始簽章檔案的網址 |
|
熟
|
processed | boolean |
簽名是否已被處理 |
|
record_id
|
record_id | string |
相關紀錄的識別碼 |
|
儲存
|
stored | boolean |
簽名是否已被儲存 |
|
縮圖
|
thumbnail | uri |
簽名縮圖版本的網址 |
|
updated_at
|
updated_at | date-time |
簽名最後更新的時間戳記 |
|
updated_by
|
updated_by | string |
最後更新簽名的使用者顯示名稱 |
|
updated_by_id
|
updated_by_id | string |
最後更新簽名的使用者 ID |
|
已上傳
|
uploaded | boolean |
簽名是否已上傳 |
|
URL
|
url | uri |
API URL 以取得此簽章 |
簽名回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
current_page
|
current_page | integer | |
|
per_page
|
per_page | integer | |
|
簽名
|
signatures | array of Signature | |
|
total_count
|
total_count | integer | |
|
total_pages
|
total_pages | integer |
單光回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
相片
|
photo | Photo |
單曲回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資料列
|
record | Record |
單一簽名回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
特徵標記
|
signature | Signature |
單筆回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
短劇
|
sketch | Sketch |
草圖
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
access_key
|
access_key | string |
草圖的唯一識別碼 |
|
content_type
|
content_type | string |
草圖檔案的 MIME 類型 |
|
建立於
|
created_at | date-time |
草圖製作的時間戳記 |
|
創建者
|
created_by | string |
顯示創建草圖的使用者名稱 |
|
created_by_id
|
created_by_id | string |
創建草圖的使用者ID |
|
EXIF
|
exif | object |
草圖中的EXIF元資料 |
|
file_size
|
file_size | integer |
草圖檔案大小(位元組) |
|
form_id
|
form_id | string |
相關表單的識別碼 |
|
大型
|
large | uri |
速寫大版網址 |
|
適中
|
medium | uri |
短劇中等版本的網址 |
|
原始
|
original | uri |
原始版本短劇的網址 |
|
熟
|
processed | boolean |
草圖是否經過處理 |
|
record_id
|
record_id | string |
相關紀錄的識別碼 |
|
小
|
small | uri |
短劇小版的網址 |
|
儲存
|
stored | boolean |
草圖是否已被保存 |
|
縮圖
|
thumbnail | uri |
草圖縮圖版本的網址 |
|
updated_at
|
updated_at | date-time |
速寫最後更新的時間戳記 |
|
updated_by
|
updated_by | string |
最後更新草圖的使用者顯示名稱 |
|
updated_by_id
|
updated_by_id | string |
最後更新草圖的使用者身分 |
|
已上傳
|
uploaded | boolean |
草圖是否已上傳 |
|
URL
|
url | uri |
存取此草稿資源的 API URL |
小品回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
current_page
|
current_page | integer | |
|
per_page
|
per_page | integer | |
|
短劇
|
sketches | array of Sketch | |
|
total_count
|
total_count | integer | |
|
total_pages
|
total_pages | integer |
視訊
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
access_key
|
access_key | string |
影片唯一識別碼 |
|
content_type
|
content_type | string |
影片檔案的 MIME 類型 |
|
建立於
|
created_at | date-time |
影片製作的時間戳記 |
|
創建者
|
created_by | string |
建立影片使用者的顯示名稱 |
|
created_by_id
|
created_by_id | string |
製作影片的使用者身分證 |
|
deleted_at
|
deleted_at | date-time |
影片被刪除的時間戳記 |
|
file_size
|
file_size | integer |
影片檔案大小(位元組) |
|
form_id
|
form_id | string |
相關表單的識別碼 |
|
適中
|
medium | uri |
中等版本影片的網址 |
|
中繼資料
|
metadata | object |
關於影片的額外元資料 |
|
原始
|
original | uri |
原始影片檔案的網址 |
|
熟
|
processed | boolean |
影片是否經過處理 |
|
record_id
|
record_id | string |
相關紀錄的識別碼 |
|
小
|
small | uri |
影片小版網址 |
|
狀態
|
status | string |
影片處理狀態 |
|
儲存
|
stored | boolean |
影片是否已被儲存 |
|
thumbnail_huge
|
thumbnail_huge | uri |
巨大縮圖的網址 |
|
thumbnail_huge_square
|
thumbnail_huge_square | uri |
巨大的方形縮圖網址 |
|
thumbnail_large
|
thumbnail_large | uri |
大型縮圖的網址 |
|
thumbnail_large_square
|
thumbnail_large_square | uri |
大型方形縮圖的網址 |
|
thumbnail_medium
|
thumbnail_medium | uri |
中等縮圖的網址 |
|
thumbnail_medium_square
|
thumbnail_medium_square | uri |
中等正方形縮圖的網址 |
|
thumbnail_small
|
thumbnail_small | uri |
小型縮圖連結 |
|
thumbnail_small_square
|
thumbnail_small_square | uri |
小方形縮圖的網址 |
|
曲目
|
track | uri |
影片曲目資料的 JSON 格式網址(如有提供) |
|
updated_at
|
updated_at | date-time |
影片最後更新的時間戳記 |
|
updated_by
|
updated_by | string |
顯示最後更新影片的使用者名稱 |
|
updated_by_id
|
updated_by_id | string |
最後更新影片的用戶身分 |
|
已上傳
|
uploaded | boolean |
影片是否已被上傳 |
|
URL
|
url | uri |
存取此影片資源的 API URL |
影片回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
current_page
|
current_page | integer | |
|
per_page
|
per_page | integer | |
|
total_count
|
total_count | integer | |
|
total_pages
|
total_pages | integer | |
|
videos
|
videos | array of Video |
FulcrumWebhookPayload
Fulcrum 的 Webhook 事件有效載荷
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
事件識別碼
|
id | string |
事件的唯一識別碼 |
|
事件類型
|
type | string |
事件類型(例如:record.create、record.update、record.delete、form.create、form.update、form.delete、choice_list.create、choice_list.update、choice_list.delete、classification_set.create、classification_set.update、classification_set.delete) |
|
負責人識別碼
|
owner_id | string |
擁有這個 webhook 的組織 ID |
|
事件資料
|
data | object |
與事件相關的紀錄或資源資料 |
|
創建於
|
created_at | date-time |
事件發生的時間戳記 |
二進位
這是基本數據類型 『binary』。