Visão geral da API REST
Bem-vindo à referência da API REST do PlayFab. Aqui você encontrará material de referência e entenderá como nossas APIs funcionam. Cada referência de API é dividida em várias seções diferentes.Ponto de extremidade
O ponto de extremidade é a URL HTTP na qual você pode fazer solicitações de API. Ele é precedido por um tipo de método REST (por exemplo, GET, POST). Além disso, o titleId deve ser substituído pelo titleId do seu jogo. Exemplo:Corpo da solicitação
O corpo da solicitação é o modelo de objeto enviado (em JSON) ao nosso serviço de API. Esses modelos contêm propriedades que precisam ser enviadas junto com sua API como conteúdo. Algumas propriedades são sinalizadas como obrigatórias, enquanto outras são opcionais.Respostas
O serviço de API retornará um 200 OK com um conteúdo JSON que pode ser desserializado como um modelo. No exemplo abaixo, as chamadas da API de login são desserializadas em um tipo LoginResult.
Segurança
Cada API tem alguma forma de segurança que precisa ser passada no cabeçalho de cada solicitação. Consulte esta seção para saber o que precisa ser definido. Às vezes, isso é um tíquete de sessão de uma solicitação de login, ou pode ser a chave secreta do seu título se você estiver fazendo solicitações de API de servidor.Simultaneidade
O serviço de API foi projetado para lidar com um número muito grande de chamadas simultâneas de cada título, mas há limites e restrições quanto ao número de chamadas simultâneas que podem acessar um único jogador ou outra entidade única, como um personagem ou grupo. Se esse limite de simultaneidade for excedido, a API retornará um código de erroAPIConcurrentRequestLimitExceeded ou ConcurrentEditError. Em geral, é seguro fazer mais de uma solicitação de leitura para um determinado jogador simultaneamente, mas é melhor fazer uma única solicitação de atualização por vez.