POST /give/pals/{player_identifier}
Ponto final: POST /v1/pdapi/give/pals/<player_identifier>
Autenticação: Token do portador
Permissão: REST.Pals.Give
Objetivo
Dá um ou mais Pals por ID e nível.
Parâmetros de caminho
player_identifier:UserIdouPlayerUIDpara o jogador alvo.
Parâmetros de consulta
Nenhum.
Solicitar corpo
JSON object com Pals, um array de concessões Pal. Cada entrada precisa de um PalID e um Level positivo.
Esquema de resposta
200 response schema
| Field | Type | Description |
|---|---|---|
Granted |
object | Counts granted by the request. |
Granted object schema:
| Field | Type | Description |
|---|---|---|
Pals |
integer | Number of Pals granted. |
Respostas de erro
Os corpos de erro usam esta forma:
| HTTP | Código de erro | Quando isso acontece |
|---|---|---|
401 |
INVALID_TOKEN |
O cabeçalho Authorization está ausente, malformado ou não corresponde a um token de portador configurado. |
403 |
MISSING_PERMISSION |
O token é válido, mas não inclui essa permissão de endpoint. |
400 |
INVALID_JSON |
Um corpo de solicitação foi fornecido, mas não pôde ser analisado como JSON. |
400 |
REQUEST_FAILED |
O retorno de chamada do thread do jogo gerou uma exceção ou um resolvedor player/resource compartilhado falhou. |
500 |
REQUEST_TIMEOUT |
O retorno de chamada do thread de jogo interno não foi concluído em 5 segundos. |
400 |
INVALID_REQUEST |
O corpo não contém um Pals array. |
400 |
VALIDATION_FAILED |
Uma ou mais concessões de Pal são inválidas ou o jogador não tem espaço de armazenamento de Pal suficiente. |
Exemplos
Dê um Pal inicial para um jogador GDK
Dê Pals ao evento por PlayerUID
Cenários
- Dê recompensas simples ao Pal sem manter um arquivo de modelo.
- Use para scripts de recompensa aleatórios que variam apenas
PalIDeLevel. - A solicitação pode falhar se o player não puder ser encontrado, se o
PalIDfor inválido ou se não houver espaço de armazenamento suficiente no Pal.