POST /forgettech/{player_identifier}

Endpunkt: POST /v1/pdapi/forgettech/<player_identifier>

Auth: Bearer-Token

Berechtigung: REST.Techs.Forget

Zweck

Entfernt eine, mehrere oder alle erlernten Technologien eines Spielers.

Pfadparameter

player_identifier: UserId oder PlayerUID des Zielspielers.

Query-Parameter

Keine.

Request-Body

Technology kann eine einzelne TechID, die Zeichenfolge "All" oder ein Array aus TechID-Zeichenfolgen sein. "All" darf nicht innerhalb eines Arrays stehen.

Antwortschema

Schema der 200-Antwort

Feld	Typ	Beschreibung
`ForgottenCount`	integer	Anzahl der vom Spieler entfernten Technologien.
`Forgotten`	string[] oder string	Entfernte Technologie-IDs oder `All`, wenn alle freigeschalteten Technologien entfernt wurden.
`Skipped`	string[]	Übersprungene Technologie-IDs, weil sie nicht freigeschaltet waren.

Fehlerantworten

Fehlerantworten verwenden dieses Format:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Für Menschen lesbare Nachricht",
        "Details": {}
    }
}

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` fehlt oder ist keine Zeichenfolge beziehungsweise kein Array im erwarteten Format.
`400`	`VALIDATION_FAILED`	Das `Technology`-Array enthält einen Wert, der keine Zeichenfolge ist, `All` oder eine ungültige Technologiekennung.

Beispiele

Eine Technologie eines GDK-Spielers entfernen

POST /v1/pdapi/forgettech/gdk_2533274812345678

{
    "Technology": "Technology_ElecBaton"
}

Mehrere Technologien anhand der PlayerUID entfernen

POST /v1/pdapi/forgettech/b7f4e91a-2c53-4d8f-a6e1-93c4bb62a7d1

{
    "Technology": [
        "Technology_ElecBaton",
        "Technology_GrapplingGun"
    ]
}

Alle Technologien eines Steam-Spielers entfernen

POST /v1/pdapi/forgettech/steam_76561198012345678

{
    "Technology": "All"
}

Szenarien

Eine versehentlich gewährte Technologie entfernen.
Ein Testkonto mit "All" zurücksetzen.
Den aktuellen Zustand vor und nach der Anfrage mit GET /techs prüfen.