Aller au contenu

GET /techs/{player_identifier}

Point final : GET /v1/pdapi/techs/<player_identifier>

Auth : Jeton du porteur

Autorisation : REST.Techs.Read

Objectif

Répertorie les informations technologiques d'un joueur. Les identifiants technologiques peuvent être recherchés sur paldeck.cc/technology.

Paramètres du chemin

  • player_identifier : UserId ou PlayerUID pour le joueur cible.

Paramètres de requête

Aucun.

Corps de la demande

Aucun corps de requête.

Schéma de réponse

200 response schema

Field Type Description
Meta object Technology count metadata for the target player.
Techs object Technology data for the target player.

Meta object schema:

Field Type Description
PlayerUID string Player UID used by Palworld save data.
Player string Player identifier supplied in the request path.
UnlockedCount integer Number of currently unlocked technologies.
LockedCount integer Number of currently locked technologies.
TotalCount integer Total number of recipe technologies known to the player data.

Techs object schema:

Field Type Description
Unlocked string[] Technology IDs currently learned by the player.

Réponses aux erreurs

Les corps d'erreur utilisent cette forme :

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Human-readable message",
        "Details": {}
    }
}
HTTP Code d'erreur Quand ça arrive
401 INVALID_TOKEN L'en-tête Authorization est manquant, mal formé ou ne correspond pas à un jeton de support configuré.
403 MISSING_PERMISSION Le jeton est valide, mais il n'inclut pas cette autorisation de point de terminaison.
400 INVALID_JSON Un corps de requête a été fourni, mais il n'a pas pu être analysé comme JSON.
400 REQUEST_FAILED Le joueur cible, le compte de joueur, les données technologiques ou le tableau technologique n'ont pas pu être résolus.
500 REQUEST_TIMEOUT Le rappel du thread de jeu interne ne s'est pas terminé dans les 5 secondes.

Exemples

Lire les technologies déverrouillées par UserID

GET /v1/pdapi/techs/gdk_2533274812345678

Lire les technologies débloquées par PlayerUID

GET /v1/pdapi/techs/f0a1c3e9-7d5b-4a28-8c33-411fdc2e6b74

Scénarios

  • Vérifiez si un joueur possède déjà un TechID avant de l'apprendre ou de l'oublier.
  • Créez une page d'administration qui sépare les technologies déverrouillées et disponibles.
  • Progression de l'audit après les actions de support.