POST /forgettech/{player_identifier}
Endpunkt: POST /v1/pdapi/forgettech/<player_identifier>
Auth: Bearer-Token
Berechtigung: REST.Techs.Forget
Zweck
Forgets one, many, or all technologies for a player.
Pfadparameter
player_identifier:UserIdoderPlayerUIDdes Zielspielers.
Query-Parameter
Keine.
Request-Body
Technology can be a single TechID, the string "All", or an array of TechID strings. Do not put "All" inside an array.
Antwortschema
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. |
Fehlerantworten
Fehlerantworten verwenden dieses Format:
| HTTP | Fehlercode | Wann es passiert |
|---|---|---|
401 |
INVALID_TOKEN |
Der Authorization-Header fehlt, ist fehlerhaft oder passt zu keinem konfigurierten Bearer-Token. |
403 |
MISSING_PERMISSION |
Das Token ist gültig, enthält aber nicht die Berechtigung für diesen Endpunkt. |
400 |
INVALID_JSON |
Ein Request-Body wurde gesendet, konnte aber nicht als JSON gelesen werden. |
400 |
REQUEST_FAILED |
Der Game-Thread-Callback hat eine Ausnahme ausgelöst oder ein gemeinsamer Spieler-/Ressourcen-Resolver ist fehlgeschlagen. |
500 |
REQUEST_TIMEOUT |
Der interne Game-Thread-Callback wurde nicht innerhalb von 5 Sekunden abgeschlossen. |
400 |
INVALID_REQUEST |
Technology is missing, or it is not a string/array in the expected format. |
400 |
VALIDATION_FAILED |
The Technology array contains a non-string, All, or an invalid technology identifier. |
Beispiele
Forget one technology for a GDK player
Forget several technologies by PlayerUID
Forget all technologies for a Steam player
Szenarien
- Remove a technology granted by mistake.
- Reset a test account with
"All". - Confirm the current state with GET /techs before and after the request.