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

200 response schema

Field	Type	Description
Granted	object	Progression values granted by the request.
Totals	object	Updated totals for granted currencies, when applicable.

Granted object schema:

Field	Type	Description
EXP	integer	EXP granted, when requested.
Relics	object	Relic point amounts granted by relic type, when requested.
TechnologyPoints	integer	Technology points granted, when requested.
AncientTechnologyPoints	integer	Ancient technology points granted, when requested.

Totals object schema:

Field	Type	Description
Relics	object	Updated relic point totals by relic type, when Relics was granted.
TechnologyPoints	integer	Updated technology point total, when TechnologyPoints was granted.
AncientTechnologyPoints	integer	Updated ancient technology point total, when AncientTechnologyPoints was granted.

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.