Obtention de la liste des comptes supprimés depuis un service

Cette méthode fournit la liste des userId des utilisateurs qui ont demandé la suppression de leur compte et de leurs données des services XBOX conformément au Règlement général sur la protection des données (RGPD). Pour toute autre question relative à la conformité au RGPD, adressez-vous à l’équipe de conformité juridique de votre organisation. La liste des comptes supprimés peut également être récupérée manuellement via le portail Partner Center. Cette API ne doit pas être appelée en continu. Un éditeur ne doit l’utiliser que quelques fois par jour au maximum. Si le service est appelé trop fréquemment, il renvoie l’erreur HTTP 429 (Too many requests), accompagnée d’informations sur le moment où le prochain appel pourra être effectué.

Requête

Prérequis

Pour utiliser cette méthode, vous devez utiliser un jeton XBOX Secure Token Service (XSTS) pour la partie de confiance https://xboxlive.com/. Pour plus d’informations, consultez Appels des services de titre aux services XBOX.

Syntaxe de la requête

Méthode	URI de la requête
GET	`https://deletedaccounts.xboxlive.com/ids`

En-tête de la requête

En-tête	Type	Description
Authorization	string	Obligatoire. Le jeton XSTS d’autorisation du service.
Signature	string	Obligatoire.
User-Agent	string	Facultatif mais recommandé. Permet d’identifier votre service à des fins de journalisation et d’investigation.
Host	string	Doit être défini sur la valeur deletedaccounts.xboxlive.com.
Content-Type	string	Spécifie le type de la requête et de la réponse. Actuellement, la seule valeur prise en charge est application/json.

Paramètres d’URI de la requête

Paramètre	Type	Description	Obligatoire
StartDate	string	Spécifie le début de la plage de dates des demandes de suppression de compte (YYYY-MM-DDTHH:MM:SS), en UTC	Non
EndDate	string	Spécifie la fin de la plage de dates des demandes de suppression de compte (YYYY-MM-DDTHH:MM:SS), en UTC	Non

L’API ne prend en compte que le jour dans vos valeurs StartDate et EndDate. Les heures, minutes et secondes sont ignorées.

Exemple de requête

GET https://deletedaccounts.xboxlive.com/ids?StartDate=2020-02-24T00:00:00&EndDate=2020-02-25T00:00:00 HTTP/1.1
Authorization: XBL3.0 x=2218837447227500391;eyJlbmMiOiJ...
Signature: AAAAAQHVT...
User-Agent: {identifier string of your service}
Content-Type: application/json;
Host: deletedaccounts.xboxlive.com

Réponse

HTTP/1.1 200 OK
Cache-Control: no-cache, no-store
Content-Length: 78296
Content-Type: application/json
X-Content-Type-Options: nosniff
MS-CV: QLHKwZlzGkqLt4smjd+qqQ.2.5.0
Date: Wed, 26 Feb 2020 00:23:34 GMT

[
    {
        "publisher": {
            "Id": "4dcc8ca0-72cc-4cfb-888c-cfddda8d2ebe",
            "Name": ""
        },
        "Ids": [
            "89E3C2A11A16CB93BD99D756377EA750DD493D95",
            "EB1F2FCEDC0B166084D5111810BA2F1156B416CE",
            ...
            "0ACFB1A45A7E0F49EF96729F036ECF555C0A4D75",
            "7187F79C48F1B6CB9FBA8C764B379C6ADB60D182"
        ]
    }
]

Corps de la réponse

Paramètre	Type	Description	Obligatoire
Publisher	PublisherInformation	Informations d’identification de l’éditeur lié à l’autorisation de la requête. Consultez le tableau de l’objet PublisherInformation ci-dessous	Oui
Ids	list<string>	Tableau des userId des utilisateurs qui ont demandé la suppression de leur compte et de leurs données. Par défaut, ces ID sont les PXUID des comptes pour l’éditeur appelant. Si l’éditeur est autorisé à accéder aux XUID et à les utiliser dans ses services, les ID sont renvoyés sous forme de XUID des utilisateurs.	Oui

L’objet PublisherInformation contient les paramètres suivants.

Paramètre	Type	Description	Obligatoire
Id	string	PublisherId correspondant au certificat de partenaire commercial utilisé pour l’authentification. Il figure au début du champ « Délivré à : » du certificat de partenaire commercial	Oui
Name	string	Nom de l’éditeur sous forme de chaîne. Ce champ est généralement vide.	Non

Codes d’erreur HTTP

Code	Erreur	Code d’erreur interne	Description
401	Unauthorized	Expired Token	Le jeton XSTS a expiré et un nouveau jeton est nécessaire pour effectuer l’appel.
403	Unauthorized	Invalid Token	Le jeton utilisé n’est pas autorisé à s’authentifier auprès de ce point de terminaison. Il peut s’agir d’un jeton destiné au mauvais sandbox ou à la mauvaise partie de confiance.
429	Throttled	Too frequent calls	Le service a été appelé trop de fois pour l’utilisateur au regard des limites d’appels spécifiées. Consultez la réponse pour savoir quand votre service pourra à nouveau appeler le service pour cet utilisateur.

Voir aussi

Référence RESTful des services XBOX Appels des services de titre aux services XBOX

XBOX Services

PlayFab

Obtention de la liste des comptes supprimés depuis un service

Requête

Prérequis

Syntaxe de la requête

En-tête de la requête

Paramètres d’URI de la requête

Exemple de requête

Réponse

Corps de la réponse

Codes d’erreur HTTP

Voir aussi

​Requête

​Prérequis

​Syntaxe de la requête

​En-tête de la requête

​Paramètres d’URI de la requête

​Exemple de requête

​Réponse

​Corps de la réponse

​Codes d’erreur HTTP

​Voir aussi

Requête

Prérequis

Syntaxe de la requête

En-tête de la requête

Paramètres d’URI de la requête

Exemple de requête

Réponse

Corps de la réponse

Codes d’erreur HTTP

Voir aussi