跳轉到主要內容
playfab api 會依路徑呼叫任何 PlayFab API 端點、傳送您傳遞的要求本文,並以 JSON 寫入 PlayFab 的回應。若要尋找作業及其要求本文,請參閱尋找 API。
此命令需要 PlayFab 遊戲,但工作室 API (/Studio/*) 除外,因為這些 API 的範圍不限於單一遊戲。請參閱內容。 命令所變更的內容取決於路徑。名稱以 Get、List 或 Search 開頭的作業只會讀取。Delete* 和 Shutdown* 作業會在終端機中先詢問,在其他環境中則需要 --confirm (--yes、-y)。請參閱安全性和破壞性作業。

引數和選項

--body 和 --body-file 無法合併使用。CLI 會按照您傳遞的內容傳送本文,而不進行驗證。

範例

從 stdin 讀取要求本文

stdin 提供一個要求本文,會讀取到輸入結尾為止,而不是每行一個要求。使用 --body-file - 時,即使在終端機中,Delete* 和 Shutdown* 作業也需要 --confirm,因為 stdin 無法回應提示。

在 Windows 上從 Git Bash 執行

Git Bash 與其他 MSYS 殼層一樣,會在啟動 Windows 程式之前,將以 / 開頭的引數轉換為 Windows 路徑。CLI 會拒絕轉換後的路徑,並說明如何修正:
為單一命令設定 MSYS_NO_PATHCONV=1:
或將其匯出,套用於工作階段的其餘部分:
關閉轉換後,Git Bash 也不會轉換其他路徑,因此請將相對路徑或 Windows 路徑 (例如 C:/requests/search.json,而非 /c/requests/search.json) 傳遞給 --body-file。

輸出

PlayFab 的回應,包裝在其 {code,status,data} 信封中;請參閱回應信封。呼叫失敗時,命令會將錯誤寫入 stderr,並以代碼 1 結束;請參閱錯誤回應。 playfab api 不接受 --output table。
最後修改於 2026年11月19日