POST /forgettech/{player_identifier}
Ponto final: POST /v1/pdapi/forgettech/<player_identifier>
Autenticação: Token do portador
Permissão: REST.Techs.Forget
Objetivo
Esquece uma, muitas ou todas as tecnologias de um jogador.
Parâmetros de caminho
player_identifier:UserIdouPlayerUIDpara o jogador alvo.
Parâmetros de consulta
Nenhum.
Solicitar corpo
Technology pode ser um único TechID, a string "All" ou um array de strings TechID. Não coloque "All" dentro de um array.
Esquema de resposta
200 response schema
| Field | Type | Description |
|---|---|---|
ForgottenCount |
integer | Number of technologies removed from the player. |
Forgotten |
string[] or string | Removed technology IDs, or All when every unlocked technology was removed. |
Skipped |
string[] | Technology IDs skipped because they were not unlocked. |
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 |
Technology está faltando ou não é um string/array no formato esperado. |
400 |
VALIDATION_FAILED |
O Technology array contém um identificador de tecnologia não string, All ou um identificador de tecnologia inválido. |
Exemplos
Esqueça uma tecnologia para um player GDK
Esqueça várias tecnologias por PlayerUID
Esqueça todas as tecnologias para um jogador Steam
Cenários
- Remova uma tecnologia concedida por engano.
- Redefina uma conta de teste com
"All". - Confirme o estado atual com GET /techs antes e depois da solicitação.