메인 콘텐츠로 건너뛰기
playfab api는 경로로 모든 PlayFab API 엔드포인트를 호출하고, 전달한 요청 본문을 보내며, PlayFab의 응답을 JSON으로 씁니다. 작업과 해당 요청 본문을 찾으려면 API 찾기를 참조하세요.
이 명령에는 PlayFab 타이틀이 필요합니다. 단, 타이틀 하나로 범위가 지정되지 않는 스튜디오 API(/Studio/*)는 예외입니다. 컨텍스트를 참조하세요. 명령이 무엇을 변경하는지는 경로에 따라 다릅니다. 이름이 Get, List 또는 Search로 시작하는 작업은 읽기만 합니다. Delete* 및 Shutdown* 작업은 터미널에서는 먼저 묻고, 그 밖의 환경에서는 --confirm(--yes, -y)이 필요합니다. 안전 및 파괴적 작업을 참조하세요.

인수 및 옵션

--body와 --body-file은 함께 사용할 수 없습니다. CLI는 본문을 유효성 검사 없이 전달한 그대로 보냅니다.

예제

stdin에서 요청 본문 읽기

stdin은 입력 끝까지 읽은 하나의 요청 본문을 제공하며, 줄마다 요청 하나를 제공하는 것이 아닙니다. --body-file -을 사용하면 stdin이 프롬프트에 응답할 수 없으므로 Delete* 및 Shutdown* 작업에는 터미널에서도 --confirm이 필요합니다.

Windows의 Git Bash에서 실행

Git Bash는 다른 MSYS 셸과 마찬가지로 Windows 프로그램을 시작하기 전에 /로 시작하는 인수를 Windows 경로로 변환합니다. CLI는 변환된 경로를 거부하고 해결 방법을 알려 줍니다.
명령 하나에 대해 MSYS_NO_PATHCONV=1을 설정합니다.
또는 세션의 나머지 부분에 대해 내보냅니다.
변환을 끄면 Git Bash가 다른 경로도 변환하지 않으므로, --body-file에는 /c/requests/search.json이 아니라 상대 경로 또는 C:/requests/search.json 같은 Windows 경로를 전달하세요.

출력

{code,status,data} 봉투에 담긴 PlayFab의 응답입니다. 응답 봉투를 참조하세요. 호출이 실패하면 명령은 오류를 stderr에 쓰고 코드 1로 종료됩니다. 오류 응답을 참조하세요. playfab api는 --output table을 허용하지 않습니다.
마지막 수정일 2026년 11월 19일