HTTP 回應狀態碼 - XBOX Game Development Documentation

本文列出全域 HTTP 回應狀態碼及其意義，同時也包含一般適用於所有 PlayFab API 的額外描述。請將此頁面作為參考指南，用來疑難排解與 HTTP Web 要求相關的問題。若要查看與特定 API 相關的描述，您必須前往該 API 的文件頁面。如果您收到此處未列出的狀態碼，請在 PlayFab 論壇上告訴我們，並將您的問題分類在 API and SDK questions 之下。

並非每個 API 都能傳回下列所有狀態碼。有些 API 只會傳回部分代碼。

HTTP 狀態碼	一般描述
100	Continue：在 HEAD 要求上傳回
200	OK：所有成功的要求都會傳回此代碼。對於大量 API，可能表示部分成功。
201	Created：要求成功，且已建立資源。
202	Accepted：要求成功，處理將以非同步方式繼續。
204	No Content：API 成功，但 API 沒有要傳回的回應。
400	Bad Request：要求中的參數無效，或要求承載結構無效。請勿重試。
401	Unauthorized：呼叫端未獲授權呼叫特定 API 或執行所要求的動作。請勿重試。
403	Forbidden：不允許呼叫端存取。請勿重試。
404	Not Found：API 不存在。請勿重試。
408	Request Timeout：要求傳送至伺服器的時間過長。可以使用指數退避模式重試。
409	Conflict：兩個 API 呼叫之間發生並行錯誤。可以使用指數退避模式重試。
413	Payload Too Large：要求大於伺服器允許處理的大小。請勿重試。如果非預期發生，請連絡支援人員。
414	URI Too Long：要求中的 URI 長度超過伺服器允許處理的長度。請勿重試。
429	Too Many Requests：API 呼叫正受到速率限制。請暫停後再重試要求，並檢查 API 是否傳回 “Retry-After” 標頭或 JSON 回應中的 retryAfter，以得知所需的延遲時間。
500	Internal Server Error：PlayFab 伺服器上發生錯誤。可以重試，如果問題持續發生，請連絡支援人員。
501	Not Implemented：所呼叫的 API 尚未實作。請勿重試。
502	Bad Gateway：PlayFab API 伺服器無法處理要求。請暫停後再使用指數退避模式重試要求。
503	Service Unavailable：PlayFab API 伺服器無法處理要求。請暫停後再使用指數退避模式重試要求。
504	Gateway Timeout：PlayFab API 伺服器無法處理要求。請暫停後再重試要求。

另請參閱

PlayFab API 參考文件

最後修改於 2026年10月6日

⌘I

​另請參閱

另請參閱