REST API 개요
PlayFab REST API 참조에 오신 것을 환영합니다. 여기에서 참조 자료를 확인하고 API 동작 방식에 대한 인사이트를 얻을 수 있습니다. 각 API 참조는 여러 섹션으로 나뉘어 있습니다.Endpoint
엔드포인트는 API 요청을 보낼 수 있는 HTTP URL입니다. 이 URL 앞에는 REST 메서드 유형(예: GET, POST)이 붙습니다. 또한 titleId는 게임의 titleId로 대체되어야 합니다. 예시:요청 본문
요청 본문은 API 서비스로 (JSON) 형식으로 전송되는 객체 모델입니다. 이 모델에는 API 호출 시 페이로드로 함께 전송해야 하는 속성이 들어 있습니다. 일부 속성은 필수로 표시되며, 나머지는 선택 사항입니다.응답
API 서비스는 200 OK를 반환하며, 모델로 역직렬화할 수 있는 JSON 페이로드를 함께 반환합니다. 아래 예에서 로그인 API 호출은 LoginResult 유형으로 역직렬화됩니다. 응답이 실패하면 4XX 오류 응답이 반환됩니다. 400 Bad Request는 API 호출에 필요한 매개변수가 누락되었거나, 속도 제한을 초과했거나, 유효성 검사 오류 등의 이유로 자주 발생할 수 있습니다. 4XX 오류가 발생한다면 요청 매개변수와 인증 토큰이 올바른지 확인하는 것이 가장 좋습니다. ApiErrorWrapper 객체에는 오류 코드, 오류 세부 정보, 서버에서 반환한 오류 메시지 등 문제를 식별하는 데 도움이 되는 유용한 정보가 담겨 있습니다.보안
각 API는 요청 헤더에 전달해야 하는 일종의 보안 정보를 요구합니다. 이 섹션을 참고하여 무엇을 정의해야 하는지 확인하세요. 로그인 요청의 세션 티켓일 수도 있고, 서버 API 요청을 보내는 경우에는 타이틀 시크릿 키가 될 수도 있습니다.동시성
API 서비스는 각 타이틀에서 매우 많은 수의 동시 호출을 처리하도록 설계되었지만, 단일 플레이어 또는 캐릭터나 그룹 같은 단일 엔티티에 대해 동시에 접근할 수 있는 호출 수에는 제한과 제약이 있습니다. 이 동시성 한도를 초과하면 API는APIConcurrentRequestLimitExceeded 또는 ConcurrentEditError 오류 코드를 반환합니다. 일반적으로 특정 플레이어에 대해 여러 개의 읽기 요청을 동시에 보내는 것은 안전하지만, 업데이트 요청은 한 번에 하나씩 보내는 것이 가장 좋습니다.