Apidog Docs
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
Learning Center
HomeSupport CenterAPI ReferencesDownloadChangelog
Learning Center
HomeSupport CenterAPI ReferencesDownloadChangelog
  1. 傳送請求
  • Back to home
  • 支援中心
  • Apidog 支援中心
  • 匯入/匯出
    • 如何將 API 資料匯入 Apidog？
    • 如何在 Apidog 中匯入 cURL？
    • 如何將 Postman 環境遷移到 Apidog？
    • 如何在匯入 Swagger/OpenAPI 時自動分組端點？
  • 傳送請求
    • Apidog 支援 Socket.IO 嗎？
    • 為什麼參數值中的「+」會被解碼為空格？
    • 如何在 Apidog 中傳送請求？
    • 如何在 Apidog 中傳送 GraphQL 請求？
    • 如何在 Apidog 中傳送 gRPC 請求？
    • 如何在 Apidog 中傳送 SOAP/WebService 請求？
    • 如何在 Apidog 中傳送 WebSocket 請求？
    • Apidog 是否支援 WebSocket API 中的預先請求／測試腳本與斷言？
    • 如何在 Apidog 中傳送 SSE 請求？
    • 如何在資料夾層級新增預設標頭？
    • Apidog 是否支援 gRPC API 中的預請求／測試腳本與斷言？
    • ELANREFUSED.DNS 解析器錯誤
    • 為什麼我在傳送請求時會收到「socket hang up」錯誤？
    • 修復請求錯誤
      • 修正 read ECONNRESET 錯誤
      • 修正 ECONNREFUSED 錯誤
      • 修正 ETIMEDOUT 錯誤
      • 修復 ENOTFOUND: Couldn't resolve host 錯誤
      • 修正 ENOTFOUND: getaddrinfo ENOTFOUND www 錯誤
      • 修復 connect EHOSTUNREACH 錯誤
  • 設計 API
    • 如何在路徑中使用變數？
    • 我可以使用回應元件作為預設回應嗎？
    • 如何查看誰修改過端點？
    • 如何在 Apidog 中批次刪除端點資料夾？
    • 如何批次新增／移除端點路徑的前綴？
    • 如何在 Schema Editor 中移動屬性的層級？
    • 如果某個字串屬性有多個列舉值，並且會用於各種位置，如何在整個文件中一致地引用此 enum？
    • 如何取得 Apidog 資源資料夾 ID？
    • 如何取得 Apidog 的資源資料夾 ID？
    • 如何在 URL 路徑中使用變數？
    • 如果端點、文件或測試情境不小心被刪除了，我該怎麼辦？
    • Apidog 是否支援自訂端點的請求程式碼？
    • 將 Swagger/OpenAPI 匯入 Apidog 時，如何自動分組端點？
    • 如何在模擬回應中產生不重複的陣列資料？
    • 為什麼路徑不支援輸入「#」？
  • 偵錯 API
    • Apidog 如何與第三方金鑰管理系統整合？
    • 為什麼相同的請求在其他工具（例如 Postman）中可以正常運作，但在 Apidog 中卻不行？
    • 如何在 Apidog 中從資料庫取得變數值？
    • 如何將環境從其他工具遷移到 Apidog？
    • 如何在 Apidog 中使用腳本進行斷言？
    • JSONPath 只能擷取陣列。如何在 Apidog 中從陣列內擷取單一元素？
    • 當不同環境有不同的資料庫帳號憑證時，如何在 Apidog 中設定資料庫操作？
    • 如何在自訂腳本中取得服務基礎 URL？
    • 當 API 回應過大時，為什麼 Apidog 會回報超過 Node.js 字串長度上限的錯誤？
    • 控制台列印的大小限制是多少？為什麼列印大型檔案時會出現錯誤？
    • 如何解決 Windows 上的 DB2 資料庫連線錯誤？
    • 為什麼我在 Apidog 中連線到 Oracle 資料庫時會出現 NJS-045 錯誤？
    • 如何在 Apidog 自訂腳本中產生動態值？
    • 為什麼用戶端請求相同端點時成功，但在網頁端除錯時卻發生「無法請求地址」錯誤？
    • 為什麼當回應過大時 Apidog 會回報錯誤？
    • 如何使用 Apidog 錄製端點？
    • 定義端點回應時，是否允許端點沒有回應內容？
    • 如何在自訂腳本中取得服務 baseURL？
    • 如何在 Apidog 中查看原始封包？
    • 為什麼我在發送請求時會看到「Invalid URI xxx」錯誤？
    • 如何在 Apidog 腳本中發出非同步請求？
    • 為什麼我在傳送請求時會看到「Couldn't resolve host」訊息？
    • 主控台列印大小限制是多少？為什麼列印大型檔案時會出現錯誤？
    • 如何在端點請求中上傳檔案？
    • 如果 Apidog 當機或未顯示回應資料該怎麼辦？
    • Apidog 用於 OAuth2.0 的官方重新導向 URI
  • Mock API 資料
    • 如何自動模擬 API？
    • Apidog 模擬可以做什麼？
    • 如何在 Apidog 中模擬固定的 API 資料？
    • 如何在 Apidog 中模擬條件式資料？
    • 如何在 Apidog 中啟用雲端模擬？
    • 如何在 Apidog 中啟用自架模擬？
    • Apidog 支援模擬 WebSocket API 嗎？
    • 為什麼瀏覽器在請求模擬端點時沒有回傳內容？
  • 自動化測試
    • 為什麼測試情境在我的本機用戶端執行時沒有問題，但在 Apidog CLI 或 runner 中執行時會發生錯誤？
    • 如何在 Apidog 中建立測試情境？
    • 如何在測試步驟之間傳遞資料？
    • 為什麼我無法成功引用前置步驟資料？
    • 如何在 Apidog 中使用 foreach 迴圈？
    • 從端點/端點案例同步資料有什麼差異？
    • 如何在 Apidog 中使用測試資料？
    • 如何在 Apidog 的腳本中擷取測試資料？
    • 如何在 Apidog 中批次執行測試情境？
    • 如何在 Apidog 中排程測試任務？
    • 如何在 Apidog 中執行效能測試？
    • 如何在效能測試中查看實際的請求與回應？
    • 如何在 Apidog 中匯出效能測試報告？
    • 如何使用資料庫查詢結果作為循環 API 請求的參數？
    • 在 CI/CD 期間於 ApiDog 中擷取並驗證 Stripe Webhook
    • 如何解決「Error: unable to verify the first certificate on runner」錯誤？
    • General Runner Docker 容器「Not Found」錯誤。
    • 如何在 Apidog Web 版中設定 General Runner 的伺服器主機？
    • 為什麼排程測試情境最後顯示 0 個請求？
    • 如果在 Runner 或 CLI 中找不到檔案上傳參數，我該怎麼辦？
    • 如何使用 Runner 執行包含上傳檔案步驟的測試場景？
    • 如何解決「Error: unable to verify the first certificate on runner」錯誤？
    • 當 Runner 發生問題時，如何存取並搜尋 Runner 日誌以識別問題？
    • 如果端點參數是上傳檔案，且在 Runner 或 CLI 中找不到，該怎麼辦？
    • 為什麼當 API 使用案例變更時，測試步驟不會自動同步？
    • 為什麼在 Markdown 文件中使用多個美元符號會導致部分內容無法正確顯示？
    • 自架 Runner 執行任務後，是否會在伺服器上產生測試報告？
    • 我可以為測試情境中的請求新增統一的前置／後置處理器嗎？
    • 如何在單次自動化測試執行期間保持動態值一致？
  • 發布 API 文件
    • 如何在已發布的文件中隱藏所有 Apidog 標誌？
    • 當 API 規格更新時，API 文件會變更嗎？
    • 如何在 Apidog 中將 API 分享給協作者？
    • 如何自訂 Apidog 文件的網域？
    • 如何在 Apidog 中建立多版本文件？
    • Apidog 中 Publish Docs Sites 的分享範圍
    • Apidog 中 Share Doc 清單的分享範圍
    • 為什麼已發布的 Share Docs 沒有顯示 hostname？
    • 文件使用者如何在共享文件中修改 Base URL？
    • 我可以複製已發布的 Apidog 文件，以便在自己的專案中使用嗎？
    • 如何在 Apidog 線上文件中共用標頭（例如 Token）？
    • 為什麼我的團隊成員找不到已發布的文件？
    • 如何修復自訂網域上的 SSL 憑證過期或 Cloudflare 526 錯誤？
    • 自訂 SMTP 設定成功，但允許清單使用者未收到 OTP 電子郵件
  • Markdown
    • 如何使用卡片連結到 Apidog 內的各種頁面或端點？
    • 為什麼在 Markdown 文件中使用多個 $ 符號時，部分內容無法正確顯示？
    • 如何在 Apidog Markdown 中使用透明背景圖片？
    • 如何設定 Markdown 表格的欄寬？
    • 如何將內部 API、文件、資料結構描述或資料夾插入 Markdown 文件？
    • 如何在 Apidog 卡片元件中新增專案內文件或端點的連結？
  • 分支
    • 如何存取 sprint 分支？
  • 管理
    • 如何靜默安裝 Apidog 用戶端？
    • 為什麼我明明有管理員存取權，卻看到「No Permission」錯誤？
    • 如何查看 Runner 版本號？
    • Apidog 支援 win7 嗎？
    • 為什麼 Apidog 安裝後會顯示錯誤「Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll」？
    • 訂閱變更與退款
    • Web 請求可正常運作，但 App 出現「read ECONNRESET」——為什麼？
    • 為什麼 Windows 系統更新後我無法開啟 Apidog？
    • 為什麼 Apidog 在 Windows 系統更新後無法開啟
  • 帳單
    • 我可以在 Apidog 中為我的團隊設定獨立的帳務帳戶嗎？
    • Apidog 上的團隊存取與帳單問題
    • 受邀團隊成員無法存取 Apidog。
    • 將個人付費團隊轉移至組織
  • 私有化部署
    • Apidog 自託管（企業）版本中的使用者與存取管理
  • Web 與用戶端
    • 下載與安裝 Linux 桌面版
  1. 傳送請求

如何在 Apidog 中傳送 gRPC 請求？

gRPC 是一個高效、快速且可靠的遠端程序呼叫（RPC）框架，廣泛用於各種情境。在微服務架構中，Apidog 有助於服務之間的高效通訊。對於涉及大量資料傳輸的情境，Apidog 會利用串流能力來降低網路延遲與頻寬消耗。
gRPC API 偵錯功能目前處於 Beta 測試階段。Apidog 版本必須等於或高於 2.3.0，才能使用 gRPC API 偵錯功能。

建立新的 gRPC 專案#

在 Apidog 首頁點擊「New Project」按鈕，並選擇「gRPC Project (Beta)」。

匯入 Proto#

gRPC 採用 API-First 方法，這表示在開發之前，必須透過 .proto 檔案定義服務、方法與訊息。因此，在使用 Apidog 偵錯 gRPC API 之前，你需要匯入作為 API 定義的 .proto 檔案。

初次匯入#

目前有兩種匯入 .proto 檔案的方式：
本機檔案
託管 .proto 檔案的 URL
選取的 .proto 檔案將作為一個 Proto 匯入，其中 service 會匯入為服務，rpc 會匯入為方法。
如果選取的 .proto 檔案依賴其他 .proto 檔案，你需要手動新增依賴目錄。
若選取的 .proto 檔案所依賴的其他 .proto 檔案中的服務，其 package 與選取的 .proto 檔案屬於相同 package，這些服務也會被匯入到同一個 Proto 中。

重新匯入#

如果已匯入的 .proto 檔案發生變更，可以在 Apidog 中重新匯入：在 Proto 上按右鍵，然後點擊「Reimport」按鈕。

呼叫方法#

使用 .proto 檔案定義 gRPC 方法時，Apidog 支援四種類型：
Unary：單向呼叫
Server Streaming：伺服器端串流
Client Streaming：用戶端串流
Bidirectional Streaming：雙向串流
Apidog 支援所有四種方法類型。

Unary 呼叫#

Unary 呼叫類似於 HTTP 請求。在地址列中輸入 URL，在 Message 分頁下以 JSON 格式輸入訊息內容，點擊「Invoke」按鈕，即會發起 unary 呼叫。
此外，你可以手動填寫 Metadata 與 Auth 資訊，以滿足驗證或其他複雜情境。

串流呼叫#

串流呼叫類似於 WebSocket 連線。發起呼叫後，你可以在 Message 分頁下撰寫並傳送訊息。伺服器端串流、用戶端串流與雙向串流都屬於串流呼叫類型。
Apidog 提供時間軸檢視，可依時間順序集中顯示呼叫狀態、已傳送訊息與已接收訊息。點擊訊息即可輕鬆查看訊息詳細資料。

進階用法#

自動產生動態值#

Apidog 可以識別 .proto 檔案中的內容，讓你點擊「Auto-generate」按鈕來產生訊息主體。若需要更彈性的動態資料，你可以使用「Dynamic Values」功能來設定並產生運算式。
請參閱 "Dynamic Values" 以取得更詳細的說明。

使用變數#

你可以在 gRPC 訊息與 Metadata 中使用 Apidog 變數。請參閱 "Environment Variable Types" 文件以取得詳細說明。

啟用 TLS#

gRPC API 支援透過 TLS 建立安全連線。
使用 Apidog 時，你可以點擊 URL 前方的通訊協定選擇器，快速切換 TLS 狀態。
此外，Apidog 相容於在 URL 中使用 grpcs:// 來為連線啟用 TLS。相反地，grpc:// 表示未啟用 TLS。

管理伺服器地址與環境#

點擊 URL 地址列右側的加號圖示，將目前使用的伺服器地址新增到環境中。
接著，在右上角選擇環境與伺服器地址，並在 URL 地址列中選擇「Follow Default」，即可使用統一的伺服器地址來偵錯所有方法。

查看 Proto 檔案與 API 參數#

查看 Proto 檔案內容#

在 Apidog 中，點擊左側目錄樹中的 Proto，即可查看 .proto 檔案的原始內容。

查看請求與回應參數#

gRPC 使用 ProtoBuf 作為序列化格式，這表示在傳送或接收訊息時，每個訊息都會以 ProtoBuf 格式傳輸。不同於其他以文字為基礎的序列化格式（JSON、XML），ProtoBuf 是一種二進位格式，不適合人類撰寫與閱讀。因此，在 Apidog 中呼叫 gRPC API 時，所有訊息都會以 JSON 格式撰寫與顯示。
你可以在 API 資訊頁面查看以 JSON 格式表示的請求與回應參數。
ProtoBuf 與 JSON 之間具有資料類型的對應關係，如下表所示：
ProtoBuf 3JSONJSON 範例
messageobject{"fooBar": v, "g": null, …}
enumstring"FOO_BAR"
map<K,V>object{"k": v, …}
repeated Varray[v, …]
boolbooleantrue, false
stringstring"Hello World!"
bytesbase64 string"YWJjMTIzIT8kKiYoKSctPUB+"
int32, fixed32, uint32number1, -10, 0
int64, fixed64, uint64string"1", "-10"
float, doublenumber1.1, -10.0, 0, "NaN", "Infinity"

儲存偵錯資訊#

完成偵錯後，點擊「Save」按鈕，將伺服器 URL、訊息、Metadata 等儲存在目前方法中，供其他團隊成員進行偵錯。
Modified at 2026-06-11 10:26:02
Previous
如何在 Apidog 中傳送 GraphQL 請求？
Next
如何在 Apidog 中傳送 SOAP/WebService 請求？
Built with