QRStuff(預覽)
QRStuff 是一個專業的 QR 碼平台。 產生動態與靜態 QR 碼、管理專案、追蹤即時掃描分析日期、國家、地區及裝置,上傳品牌資產,並管理您的帳戶。
此連接器適用於以下產品和區域:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| Name | QRStuff 支援 |
| URL | https://www.qrstuff.com/contact |
| support@qrstuff.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | QRStuff |
| Website | https://www.qrstuff.com |
| 隱私權原則 | https://www.qrstuff.com/privacy-policy |
| Categories | 生產力;行銷 |
QRStuff
Publisher:QRStuff
QRStuff 是一個專業的 QR 碼管理平台,讓使用者能產生動態與靜態 QR 碼,將它們組織成專案,追蹤即時掃描分析,並管理帳戶設定。 透過此連接器,您可以直接自動化跨業務應用程式與流程的 QR 碼工作流程。
Prerequisites
要使用這個連接器,你需要:
- QRStuff 帳號(免費註冊於 qrstuff.com)
- 付費 QRStuff 訂閱以使用動態 QR 碼管理與分析功能
支援的作業
| Operation | 類別 | Description |
|---|---|---|
| 取得使用者資料 | Account | 取得姓名、電子郵件、公司名稱、電話及時區資料 |
| 獲取訂閱詳情 | Account | 取得目前的方案、狀態及帳單資訊 |
| 列出專案 | 專案 | 列出所有帶有分頁的 QR 碼專案 |
| 建立專案 | 專案 | 建立一個新專案來組織 QR 碼 |
| 已刪除專案列表 | 專案 | 列出可恢復的軟刪除專案 |
| 還原已刪除的 Project | 專案 | 還原先前刪除的專案 |
| 清單 QR 碼 | 二維碼 | 在帳號內列出 QR 碼,並搭配搜尋和分頁 |
| 產生 QR 碼 | 二維碼 | 建立一個包含類型、內容和樣式的新 QR 碼 |
| 取得 QR Code 詳細資訊 | 二維碼 | 完整細節包括掃描次數、預覽網址、下載 URL |
| 更新 QR 碼 | 二維碼 | 更新目的地 URL、名稱或內容類型 |
| 在 Project 中列出 QR 碼 | 二維碼 | 所有特定專案內的 QR 碼 |
| 還原已刪除的 QR 碼 | 二維碼 | 還原先前刪除的 QR 碼 |
| 將 QR Code 移至 Project | 二維碼 | 將 QR 碼從一個專案移到另一個 |
| 傳輸 QR 碼 | 二維碼 | 將匿名 QR 碼轉移到已註冊帳號 |
| 取得 QR Code 歷史紀錄 | 二維碼 | 特定 QR 碼的變更與稽核歷史 |
| 上傳檔案 | 檔案儲存體 | 上傳圖片作為 QR 碼標誌或背景使用 |
| 查看帳戶總覽 | Analytics | 總專案數、QR 碼、掃描碼數與獨立使用者數 |
| 獲取帳戶活動 | Analytics | 動態 QR 使用、每月掃描次數限制、本月掃描次數 |
| 取得全掃描 | Analytics | 帳號、專案或 QR 碼的總掃描次數 |
| 獲取獨特用戶 | Analytics | 帳號、專案或 QR 碼的獨特掃描器數量 |
| 取得最佳表現約會 | Analytics | 在特定期間內掃描次數最多的一天 |
| 取得頂尖表現的地點 | Analytics | 某一期間內掃描次數最多的國家 |
| 取得頂尖掃描器 QR 碼 | Analytics | 擁有最多帳號或專案掃描的 QR 碼 |
| 取得帳號掃描 | Analytics | 分頁掃描資料依掃描、日期、國家、地區或裝置分組 |
| 取得 Project 掃描檔 | Analytics | 特定專案的分頁掃描日誌 |
| 取得 QR 碼掃描 | Analytics | 特定 QR 碼的分頁掃描日誌 |
| 按日期取得掃描 | Analytics | 掃描次數依日期分組 |
| 按國家取得掃描 | Analytics | 按國家分組的掃描次數 |
| 按地區掃描 | Analytics | 按國家區域分組的掃描計數 |
| 按裝置取得掃描 | Analytics | 依裝置平台分組的掃描次數 |
| 建立支援工單 | Support | 請向 QRStuff 團隊提交支援申請 |
| 取得 Trustpilot 評論網址 | Support | 取得個人化的 Trustpilot 評測連結 |
| 搜尋知識庫 | Support | 搜尋 QRStuff 幫助文章與常見問題 |
取得憑證
針對終端使用者
- 請在 app.qrstuff.com 登入您的 QRStuff 帳號。
- 當你在 Power Apps 或 Power Automate 中新增此連接器時,點擊登入。
- 您將被導向至 QRStuff OAuth 的登入頁面。
- 輸入你的 QRStuff 電子郵件和密碼,然後點擊 授權。
- 你會被重新導向回去,連線也會自動建立。
無需 API 金鑰或手動令牌設定——連接器使用 OAuth 2.0 並具備自動令牌更新功能。
For Microsoft 認證團隊(OAuth 應用程式註冊)
此連接器使用 RFC 7591 動態用戶端註冊(DCR)來註冊 OAuth 用戶端。 要取得有效的客戶端 ID 與客戶端秘密以供部署,請向 QRStuff 註冊端點發送 POST 請求:
-
端點:
https://api.qrstuff.com/api/oauth/register -
方法:
POST -
標題:
Content-Type: application/jsonAccept: application/json
-
請求主體:
{ "client_name": "QRStuff Power Platform Connector", "redirect_uris": ["https://global.consent.azure-apim.net/redirect"] }
回應將回傳 client_id 與 client_secret 並配置於 Microsoft Power Platform 生產環境中。
已知問題和限制
- 透過 QRStuff 網頁平台或 MCP 伺服器,支援產生新的 QR 碼(POST 以建立)。 此連接器專注於讀取、更新及管理現有的 QR 碼與專案。
- 動態 QR 碼管理需要付費訂閱。
- 分析端點(依日期、國家、裝置掃描)可透過 QRStuff MCP 伺服器連接器提供 AI 輔助工作流程。
常見問題
問:是否需要付費方案?
答:免費帳號可以讓你查看個人檔案和專案資料。 動態 QR 碼管理與分析需要付費方案。
問:我可以在哪裡獲得支持?
答:請聯絡 QRStuff 客服, qrstuff.com/contact 或寄信給 support@qrstuff.com他們。
問:支援哪些區域?
答:QRStuff API 全球皆可 api.qrstuff.com透過 。
動作
| 上傳檔案 |
上傳圖片或資產檔案(PNG、JPEG、SVG),作為標誌或背景,並以 QR 碼樣式使用。 |
| 列出專案 |
檢索一個分頁的 QR 碼專案清單。 使用 deleted=1 來列出已刪除的專案。 |
| 取得 Project 掃描檔 |
在特定專案的日期範圍內取得分頁掃描日誌。 |
| 取得 QR Code 歷史紀錄 |
取得特定 QR 碼的變更與稽核紀錄。 |
| 取得 QR Code 詳細資訊 |
取得特定 QR 碼的完整細節,包括內容、掃描次數、預覽網址及下載網址。 |
| 取得 QR 碼掃描 |
在特定日期範圍內取得特定 QR 碼的分頁掃描紀錄。 |
| 取得全掃描 |
在特定日期範圍內取得帳戶、專案或特定 QR 碼的總掃描次數。 |
| 取得帳號掃描 |
取得整個帳戶的分頁掃描資料。 使用group_by依日期、國家、地區或裝置彙整。 |
| 取得最佳表現約會 |
取得帳號、專案或 QR 碼的最高效能日期(單日最多掃描次數)。 |
| 取得頂尖掃描器 QR 碼 |
取得該帳戶或特定專案掃描次數最多的 QR 碼。 |
| 取得頂尖表現的地點 |
取得表現最好的國家(掃描次數最多)來進行帳號、專案或 QR 碼。 |
| 在 Project 中列出 QR 碼 |
取回所有屬於特定專案的 QR 碼。 |
| 將 QR Code 移至 Project |
在同一帳號中,將一個或多個 QR 碼從一個專案移到另一個專案。 |
| 建立專案 |
建立一個新專案來整理 QR 碼。 |
| 更新 QR 碼 |
更新現有 QR 碼的目的地網址、名稱或內容類型。 |
| 查看帳戶總覽 |
取得高階分析概覽:總專案、QR 碼、掃描碼及獨立使用者數。 |
| 清單 QR 碼 |
在帳號中取得分頁的 QR 碼清單。 可選擇依搜尋查詢篩選。 |
| 獲取帳戶活動 |
查詢帳戶活動:動態 QR 使用量、每月掃描次數,以及本月掃描紀錄。 |
| 獲取獨特用戶 |
在特定日期範圍內,為帳號、專案或特定 QR 碼查詢獨特的掃描器數量。 |
| 獲取用戶個人資料 |
取得已認證使用者的個人資料,包括姓名、電子郵件、公司名稱、電話號碼及時區。 |
| 獲取訂閱詳情 |
取得已認證用戶目前的訂閱方案、狀態、計費週期及貨幣。 |
| 產生 QR 碼 |
產生一個新的 QR 碼,包含指定的類型、內容及可選樣式選項。 |
| 轉帳 QR 碼(匿名) |
將匿名建立的 QR 碼所有權轉移到註冊帳號和專案。 |
| 還原已刪除的 Project |
將一個或多個先前軟刪除的專案恢復為活躍狀態。 |
| 還原已刪除的 QR 碼 |
將一個或多個先前軟刪除的 QR 碼恢復為有效狀態。 |
上傳檔案
上傳圖片或資產檔案(PNG、JPEG、SVG),作為標誌或背景,並以 QR 碼樣式使用。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
file | True | file |
要上傳的圖片檔案(PNG、JPEG 或 SVG)。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
檔案 ID
|
data.idfs_file | integer |
檔案標識碼。 |
|
檔案網址
|
data.url | string |
用來存取上傳檔案的網址。 |
列出專案
檢索一個分頁的 QR 碼專案清單。 使用 deleted=1 來列出已刪除的專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Page
|
page | integer |
頁碼(從1開始)。 |
|
|
每頁
|
per_page | integer |
每頁專案數(5-100)。 |
|
|
排序依據:
|
sort_by | string |
排序欄位。 |
|
|
排序順序
|
sort_order | string |
排序方向。 |
|
|
節目已刪除
|
deleted | integer |
設為 1 以列出已刪除的專案。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專案
|
data | array of object | |
|
專案識別碼
|
data.idproject | integer |
項目標識碼。 |
|
Name
|
data.name | string |
Project名稱。 |
|
QR 碼計數
|
data.num_codes | integer |
QR 碼數量。 |
|
目前頁面
|
meta.current_page | integer |
目前頁面。 |
|
最後一頁
|
meta.last_page | integer |
最後一頁。 |
|
Total
|
meta.total | integer |
總專案。 |
取得 Project 掃描檔
在特定專案的日期範圍內取得分頁掃描日誌。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案識別碼
|
idproject | True | integer |
專案識別碼。 |
|
開始日期
|
start_date | string |
開始日期(YYYY-MM-DD)。 |
|
|
結束日期
|
end_date | string |
結束日期(YYYY-MM-DD)。 |
|
|
分組依據
|
group_by | string |
分組。 |
|
|
Page
|
page | integer |
頁碼。 |
|
|
每頁
|
per_page | integer |
每頁的項目數。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Scans
|
data | array of object | |
|
items
|
data | object | |
|
Pagination
|
meta | object |
取得 QR Code 歷史紀錄
取得特定 QR 碼的變更與稽核紀錄。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
二維碼ID
|
idqrcode | True | integer |
QR 碼識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
History
|
data | array of object | |
|
Event
|
data.event | string |
事件類型。 |
|
Date
|
data.created_at | string |
事件發生的時候。 |
|
User
|
data.user | string |
執行動作的使用者。 |
取得 QR Code 詳細資訊
取得特定 QR 碼的完整細節,包括內容、掃描次數、預覽網址及下載網址。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
二維碼ID
|
idqrcode | True | integer |
QR 碼識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
二維碼ID
|
idqrcode | integer |
QR 碼識別碼。 |
|
Name
|
name | string |
QR 碼名稱。 |
|
類型
|
output_type | string |
QR 碼內容類型。 |
|
專案識別碼
|
idproject | integer |
專案識別碼。 |
|
短網址
|
shorturl | string |
網址很短。 |
|
預覽 URL
|
preview_url | string |
預覽圖片網址。 |
|
下載網址
|
download_url | string |
下載 URL。 |
|
全掃描
|
hits | integer |
總掃描次數。 |
取得 QR 碼掃描
在特定日期範圍內取得特定 QR 碼的分頁掃描紀錄。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
二維碼ID
|
idqrcode | True | integer |
QR 碼識別碼。 |
|
開始日期
|
start_date | string |
開始日期(YYYY-MM-DD)。 |
|
|
結束日期
|
end_date | string |
結束日期(YYYY-MM-DD)。 |
|
|
分組依據
|
group_by | string |
結果依序分類。 |
|
|
Page
|
page | integer |
頁碼。 |
|
|
每頁
|
per_page | integer |
每頁的項目數。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Scans
|
data | array of object | |
|
items
|
data | object | |
|
Pagination
|
meta | object |
取得全掃描
在特定日期範圍內取得帳戶、專案或特定 QR 碼的總掃描次數。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
分析範圍。 |
|
開始日期
|
start_date | True | string |
開始日期(YYYY-MM-DD)。 |
|
結束日期
|
end_date | True | string |
結束日期(YYYY-MM-DD)。 |
|
專案識別碼
|
idproject | integer |
Project ID(當 scope=project 或 qrcode 時必須)。 |
|
|
二維碼ID
|
idqrcode | integer |
QR 碼 ID(當範圍=qrcode 時必須)。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
全掃描
|
total | integer |
總掃描次數。 |
取得帳號掃描
取得整個帳戶的分頁掃描資料。 使用group_by依日期、國家、地區或裝置彙整。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
開始日期
|
start_date | string |
開始日期(YYYY-MM-DD)。 預設是 30 天前。 |
|
|
結束日期
|
end_date | string |
結束日期(YYYY-MM-DD)。 預設是今天。 |
|
|
分組依據
|
group_by | string |
總和。 |
|
|
Country
|
country | string |
ISO 國家/地區代碼。 當 group_by=區域時是必須的。 |
|
|
Page
|
page | integer |
頁碼。 |
|
|
每頁
|
per_page | integer |
每頁的項目數。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Scans
|
data | array of object | |
|
items
|
data | object | |
|
Pagination
|
meta | object |
取得最佳表現約會
取得帳號、專案或 QR 碼的最高效能日期(單日最多掃描次數)。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
分析範圍。 |
|
開始日期
|
start_date | True | string |
開始日期(YYYY-MM-DD)。 |
|
結束日期
|
end_date | True | string |
結束日期(YYYY-MM-DD)。 |
|
專案識別碼
|
idproject | integer |
專案識別碼。 |
|
|
二維碼ID
|
idqrcode | integer |
QR 碼識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Date
|
date | string |
最棒的約會。 |
|
Scans
|
scans | integer |
那天做的掃描。 |
取得頂尖掃描器 QR 碼
取得該帳戶或特定專案掃描次數最多的 QR 碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
範圍:帳戶或專案。 |
|
開始日期
|
start_date | True | string |
開始日期(YYYY-MM-DD)。 |
|
結束日期
|
end_date | True | string |
結束日期(YYYY-MM-DD)。 |
|
專案識別碼
|
idproject | integer |
專案識別碼。 當範圍=專案時,必須使用。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
二維碼ID
|
idqrcode | integer |
QR 碼識別碼。 |
|
Name
|
name | string |
QR 碼名稱。 |
|
Scans
|
scans | integer |
全掃描。 |
取得頂尖表現的地點
取得表現最好的國家(掃描次數最多)來進行帳號、專案或 QR 碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
分析範圍。 |
|
開始日期
|
start_date | True | string |
開始日期(YYYY-MM-DD)。 |
|
結束日期
|
end_date | True | string |
結束日期(YYYY-MM-DD)。 |
|
專案識別碼
|
idproject | integer |
專案識別碼。 |
|
|
二維碼ID
|
idqrcode | integer |
QR 碼識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Country
|
country | string |
國家/地區名稱。 |
|
Scans
|
scans | integer |
掃描計數。 |
在 Project 中列出 QR 碼
取回所有屬於特定專案的 QR 碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案識別碼
|
idproject | True | integer |
專案識別碼。 |
|
Page
|
page | integer |
頁碼。 |
|
|
每頁
|
per_page | integer |
每頁的 QR 碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
二維碼
|
data | array of object | |
|
二維碼ID
|
data.idqrcode | integer |
QR 碼識別碼。 |
|
Name
|
data.name | string |
QR 碼名稱。 |
|
類型
|
data.output_type | string |
QR 碼類型。 |
|
預覽 URL
|
data.preview_url | string |
預覽圖片網址。 |
|
全掃描
|
data.hits | integer |
全掃描。 |
將 QR Code 移至 Project
在同一帳號中,將一個或多個 QR 碼從一個專案移到另一個專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
目的地 Project ID
|
idproject | True | integer |
目的地專案識別碼。 |
|
QR Code ID
|
qrcodes | True | array of integer |
需要移動的 QR Code ID 清單。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Message
|
message | string |
結果訊息。 |
建立專案
建立一個新專案來整理 QR 碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案名稱
|
name | True | string |
新專案的名稱。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專案識別碼
|
idproject | integer |
項目標識碼。 |
|
Name
|
name | string |
Project名稱。 |
更新 QR 碼
更新現有 QR 碼的目的地網址、名稱或內容類型。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
二維碼ID
|
idqrcode | True | integer |
更新 QR 碼識別碼。 |
|
Name
|
name | string |
新名稱。 |
|
|
資料 / 網址
|
data | string |
新的目的地網址或內容。 |
|
|
類型
|
type | string |
QR 碼內容類型。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
二維碼ID
|
idqrcode | integer |
QR 碼識別碼。 |
|
Name
|
name | string |
更新名稱。 |
查看帳戶總覽
取得高階分析概覽:總專案、QR 碼、掃描碼及獨立使用者數。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
項目總數
|
total_projects | integer |
總專案。 |
|
總 QR 碼數
|
total_qrcodes | integer |
總共的 QR 碼。 |
|
全掃描
|
total_scans | integer |
全掃描。 |
|
獨特使用者
|
total_unique_users | integer |
完全獨特的掃描器。 |
清單 QR 碼
在帳號中取得分頁的 QR 碼清單。 可選擇依搜尋查詢篩選。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Page
|
page | integer |
頁碼。 |
|
|
每頁
|
per_page | integer |
每頁 QR 碼(5 到 100 個)。 |
|
|
搜尋查詢
|
q | string |
搜尋查詢以以名稱篩選。 |
|
|
排序順序
|
sort_order | string |
排序方向。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
二維碼
|
data | array of object | |
|
二維碼ID
|
data.idqrcode | integer |
QR 碼識別碼。 |
|
Name
|
data.name | string |
QR 碼名稱。 |
|
類型
|
data.output_type | string |
QR 碼類型。 |
|
專案識別碼
|
data.idproject | integer |
專案識別碼。 |
|
短網址
|
data.shorturl | string |
網址很短。 |
|
預覽 URL
|
data.preview_url | string |
預覽圖片網址。 |
|
目前頁面
|
meta.current_page | integer |
目前頁面。 |
|
Total
|
meta.total | integer |
總共的 QR 碼。 |
獲取帳戶活動
查詢帳戶活動:動態 QR 使用量、每月掃描次數,以及本月掃描紀錄。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
動態 QR 碼使用的應用
|
dynamic_qrcodes_used | integer |
使用動態 QR 碼。 |
|
動態 QR 碼限制
|
dynamic_qrcodes_limit | integer |
動態 QR 碼限制。 |
|
本月掃描
|
scans_this_month | integer |
本月掃描。 |
|
掃描次數限制
|
scans_limit | integer |
每月掃描次數限制。 |
獲取獨特用戶
在特定日期範圍內,為帳號、專案或特定 QR 碼查詢獨特的掃描器數量。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
分析範圍。 |
|
開始日期
|
start_date | True | string |
開始日期(YYYY-MM-DD)。 |
|
結束日期
|
end_date | True | string |
結束日期(YYYY-MM-DD)。 |
|
專案識別碼
|
idproject | integer |
Project ID(當 scope=project 或 qrcode 時必須)。 |
|
|
二維碼ID
|
idqrcode | integer |
QR 碼 ID(當範圍=qrcode 時必須)。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
獨特使用者
|
unique_users | integer |
獨立用戶數。 |
獲取用戶個人資料
取得已認證使用者的個人資料,包括姓名、電子郵件、公司名稱、電話號碼及時區。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
用戶端識別碼
|
idclient | integer |
唯一的客戶端識別碼。 |
|
名字
|
first_name | string |
名字。 |
|
姓氏
|
last_name | string |
姓。 |
|
使用者名稱
|
username | string |
電子郵件地址/使用者名稱。 |
|
公司名稱
|
business_name | string |
企業或組織名稱。 |
|
手機號碼
|
phone_number | string |
電話號碼。 |
|
Timezone
|
timezone | string |
使用者時區(例如亞洲/加爾各答)。 |
獲取訂閱詳情
取得已認證用戶目前的訂閱方案、狀態、計費週期及貨幣。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Plan
|
plan | string |
訂閱方案名稱。 |
|
Status
|
status | string |
訂閱狀態(例如有效、已取消)。 |
|
下一個計費日期
|
next_billing_at | string |
下一個帳單日期。 |
|
貨幣
|
currency_code | string |
帳單貨幣代碼(例如美元)。 |
產生 QR 碼
產生一個新的 QR 碼,包含指定的類型、內容及可選樣式選項。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
新QR碼的名稱。 |
|
類型
|
output_type | True | string |
QR 碼內容類型。 |
|
專案識別碼
|
idproject | True | integer |
Project ID 用來放入 QR 碼。 |
|
資料 / 內容
|
data | string |
QR 碼的內容(例如 URL 或文字)。 |
|
|
框架名稱
|
frame_name | string |
框架風格名稱。 |
|
|
標誌圖片識別碼
|
qr_code_logo_image | string |
將標誌圖片ID嵌入QR碼中。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
二維碼ID
|
idqrcode | integer |
新的 QR 碼識別碼。 |
|
Name
|
name | string |
QR 碼名稱。 |
|
預覽 URL
|
preview_url | string |
預覽圖片網址。 |
|
短網址
|
shorturl | string |
簡短的重定向網址。 |
轉帳 QR 碼(匿名)
將匿名建立的 QR 碼所有權轉移到註冊帳號和專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案識別碼
|
idproject | integer |
目標專案ID。 |
|
|
QR Code ID
|
qrcode_ids | array of integer |
要轉帳的 QR 碼 ID。 |
|
|
短網址鍵
|
shorturl_keys | array of string |
短網址金鑰用於傳輸(替代 ID 的使用)。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Message
|
message | string |
結果訊息。 |
還原已刪除的 Project
將一個或多個先前軟刪除的專案恢復為活躍狀態。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案識別碼
|
project_ids | True | array of integer |
待修復的專案 ID 清單。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Message
|
message | string |
結果訊息。 |
還原已刪除的 QR 碼
將一個或多個先前軟刪除的 QR 碼恢復為有效狀態。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
QR Code ID
|
qrcode_ids | array of integer |
需修復的 QR Code ID 清單。 |
|
|
短網址鍵
|
shorturl_keys | array of string |
還原的短網址金鑰清單(替代 ID 的替代方案)。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Message
|
message | string |
結果訊息。 |