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 유형으로 역직렬화됩니다.
보안
각 API는 요청 헤더에 전달해야 하는 일종의 보안 정보를 요구합니다. 이 섹션을 참고하여 무엇을 정의해야 하는지 확인하세요. 로그인 요청의 세션 티켓일 수도 있고, 서버 API 요청을 보내는 경우에는 타이틀 시크릿 키가 될 수도 있습니다.동시성
API 서비스는 각 타이틀에서 매우 많은 수의 동시 호출을 처리하도록 설계되었지만, 단일 플레이어 또는 캐릭터나 그룹 같은 단일 엔티티에 대해 동시에 접근할 수 있는 호출 수에는 제한과 제약이 있습니다. 이 동시성 한도를 초과하면 API는APIConcurrentRequestLimitExceeded 또는 ConcurrentEditError 오류 코드를 반환합니다. 일반적으로 특정 플레이어에 대해 여러 개의 읽기 요청을 동시에 보내는 것은 안전하지만, 업데이트 요청은 한 번에 하나씩 보내는 것이 가장 좋습니다.