POST /give/progression/{player_identifier}

Endpunkt: POST /v1/pdapi/give/progression/<player_identifier>

Auth: Bearer-Token

Berechtigung: REST.Progression.Give

Zweck

Gewährt einem Spieler Fortschrittswerte.

Pfadparameter

player_identifier: UserId oder PlayerUID des Zielspielers.

Query-Parameter

Keine.

Request-Body

JSON-Objekt mit mindestens einer unterstützten Vergabe: positive Ganzzahl EXP, positive Ganzzahl TechnologyPoints, positive Ganzzahl AncientTechnologyPoints oder Relics als nicht leeres Objekt, das Relikt-Typen positive Ganzzahlen zuordnet.

Unterstützte Relikt-Typen: CapturePower, HungerReduction, SwimSpeed, FoodDecayReduction, JumpPower, GliderSpeed, ClimbSpeed, StatusAilmentResist, StaminaReduction, SphereHoming, ExpBonus, RainbowPassiveRate, MoveSpeed.

Antwortschema

Schema der 200-Antwort

Feld	Typ	Beschreibung
`Granted`	object	Durch die Anfrage gewährte Fortschrittswerte.
`Totals`	object	Aktualisierte Summen gewährter Währungen, sofern zutreffend.

Schema des Granted-Objekts:

Feld	Typ	Beschreibung
`EXP`	integer	Gewährte EXP, sofern angefordert.
`Relics`	object	Nach Relikttyp gewährte Reliktpunkte, sofern angefordert.
`TechnologyPoints`	integer	Gewährte Technologiepunkte, sofern angefordert.
`AncientTechnologyPoints`	integer	Gewährte antike Technologiepunkte, sofern angefordert.

Schema des Totals-Objekts:

Feld	Typ	Beschreibung
`Relics`	object	Aktualisierte Reliktpunktsummen nach Typ, wenn `Relics` gewährt wurde.
`TechnologyPoints`	integer	Aktualisierte Gesamtzahl der Technologiepunkte, wenn `TechnologyPoints` gewährt wurde.
`AncientTechnologyPoints`	integer	Aktualisierte Gesamtzahl der antiken Technologiepunkte, wenn `AncientTechnologyPoints` gewährt wurde.

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`	Der Body enthält keines der Felder `EXP`, `Relics`, `TechnologyPoints` oder `AncientTechnologyPoints`.
`400`	`VALIDATION_FAILED`	Ein angegebener Fortschrittswert fehlt, ist keine Ganzzahl, ist nicht positiv oder benötigte Fortschrittsdaten sind nicht verfügbar.

Beispiele

EXP an einen GDK-Spieler geben

POST /v1/pdapi/give/progression/gdk_2533274898765432

{
    "EXP": 25000
}

Punkte und Relikte per PlayerUID geben

POST /v1/pdapi/give/progression/f0a1c3e9-7d5b-4a28-8c33-411fdc2e6b74

{
    "Relics": {
        "CapturePower": 5,
        "MoveSpeed": 2
    },
    "TechnologyPoints": 10,
    "AncientTechnologyPoints": 2
}

Szenarien

Kompensiere Spieler nach einem Save-Rollback.
Füge Technologiepunkte hinzu, ohne eine bestimmte Technologie freizuschalten.
Nutze stattdessen POST /learntech, wenn du eine bestimmte TechID freischalten willst.