Configuration
Connectez-vous, enregistrez votre ID de titre PlayFab comme valeur par défaut et effectuez une requête en lecture seule. RemplacezABC123 par votre ID de titre.
--playfab-title-id. Consultez
Contexte.
Trouver une API
PlayFab documente chaque opération, ses schémas de requête et de réponse, les champs obligatoires et les informations d’identification qu’elle accepte :- La référence de l’API REST PlayFab est rédigée pour les personnes.
- Les spécifications Swagger de PlayFab
sont lisibles par une machine. Les fichiers sont nommés d’après les groupes d’API de PlayFab, et non d’après le premier
segment du chemin : recherchez donc l’opération dans les
pathsdes fichiers. Par exemple,/Cataloget/Inventoryse trouvent dansEconomy.swagger.json, et/Match,/Lobbyet/MultiplayerServerdansMultiplayer.swagger.json. - Le champ
securityde chaque opération nomme les informations d’identification qu’elle accepte :SecretKey(une clé secrète de titre),EntityToken,SessionTicket(une session de joueur) ouNone. Certaines opérations indiquent également dans leur description les types de jetons d’entité autorisés.
/<Prefix>/<Operation>, comme /Admin/GetTitleData, et le corps de la
requête est l’objet de requête JSON de l’opération.
Exemples
Ces exemples appellent l’API avecplayfab api, qui contient la
référence complète des options. Les opérations Delete* et Shutdown* demandent d’abord confirmation dans un terminal, et nécessitent
--confirm ailleurs ; consultez Sécurité et opérations destructives.
Obtenir les données de titre
Obtenir une seule clé de données de titre
Définir des données de titre
Passez le corps de la requête directement avec--body :
--body-file, ici dans PowerShell :
Obtenir uniquement les données, sur une seule ligne
--data-only supprime l’enveloppe de réponse, et --output json-compact écrit du JSON sur une seule ligne
à transmettre à une autre commande :
Réponses d’erreur
Un appel en échec se termine avec le code1 :
- Lorsque PlayFab renvoie une erreur, la commande écrit le JSON d’erreur de PlayFab sur stderr,
mis en forme selon
--output. - Les autres échecs, comme les erreurs réseau, écrivent un message en texte brut sur stderr.
- Avec
--data-only, stdout est vide en cas d’erreur.
