API The Coven

Recherche des gardiens via leur tag Bungie au format Guardian#0001.
Vous pouvez ajouter la query emblem=true pour inclure l’URL de l’emblème du premier personnage du gardien.
Note : L’utilisation de ce paramètre peut ralentir la réponse de l’endpoint. Ne l’ajoutez que si nécessaire.
Note : le caractère # est encodé en %23 dans l’URL. Par exemple, VooDoo#0806 devient VooDoo%230806.

{
    "success": true,
    "query": "voodoo#08",
    "results": [
        {
            "name": "VooDoo#0806",
            "bungieNetMembershipId": "14927183",
            "membershipId": "4611686018467190713",
            "membershipType": 3,
            "icon": "https://bungie.net/img/theme/bungienet/icons/steamLogo.png",
            "emblemPath": "https://bungie.net/common/destiny2_content/icons/9450a105c8cc16aa559febc7312b522a.jpg"
        },
        {
            "name": "Voodoo#0839",
            "bungieNetMembershipId": "18781523",
            "membershipId": "4611686018482020821",
            "membershipType": 3,
            "icon": "https://bungie.net/img/theme/bungienet/icons/steamLogo.png",
            "emblemPath": "https://bungie.net/common/destiny2_content/icons/fb7cf21487dffd363ec02127c4993346.jpg"
        },
        {
            "name": "VooDoo#0868",
            "bungieNetMembershipId": "26306782",
            "membershipId": "4611686018491404073",
            "membershipType": 3,
            "icon": "https://bungie.net/img/theme/bungienet/icons/steamLogo.png",
            "emblemPath": "https://bungie.net/common/destiny2_content/icons/24e9133c9cc157853762de5a2c3853aa.jpg"
        }
    ],
    "AccessLevel": "premium"
}

Permet de récupérer les informations détaillées d’un gardien Destiny 2 à partir de son tag Bungie complet (format : Nom#0000).

• Le paramètre name est obligatoire et doit respecter le format exact, incluant le # suivi du code à 4 chiffres (exemple : VooDoo#0806).
• L’endpoint recherche d’abord le gardien via l’API Bungie avec ce tag, puis récupère son profil complet, incluant :
  • Les informations de base du profil (nom, ID, type d’abonnement)
  • La liste des personnages avec leurs données détaillées (dont les chemins vers leurs emblems)
• En cas d’erreur, un message clair est renvoyé pour faciliter le debug (format invalide, gardien non trouvé, problème API, etc.).

Note :
Dans l’URL, le caractère # doit être encodé en %23. Par exemple, VooDoo#0806 devient VooDoo%230806.

{
    "membershipId": "4611686018467190713",
    "membershipType": 3,
    "displayName": "VooDoo",
    "bungieDisplayName": "VooDoo#0806",
    "dateLastPlayed": "2025-07-25T09:50:58Z",
    "characterIds": [
        "2305843009299525930",
        "2305843009302904780",
        "2305843009313535740"
    ],
    "characters": {
        "2305843009299525930": {
            "membershipId": "4611686018467190713",
            "membershipType": 3,
            "characterId": "2305843009299525930",
            "dateLastPlayed": "2025-07-24T13:02:57Z",
            "minutesPlayedThisSession": "15",
            "minutesPlayedTotal": "72433",
            "light": 213,
            "stats": {
                "144602215": 41,
                "392767087": 77,
                "1735777505": 59,
                "1935470627": 213,
                "1943323491": 63,
                "2996146975": 61,
                "4244567218": 126
            },
            "raceHash": 2803282938,
            "genderHash": 2204441813,
            "classHash": 671679327,
            "raceType": 1,
            "classType": 1,
            "genderType": 1,
            "emblemPath": "https://bungie.net/common/destiny2_content/icons/9450a105c8cc16aa559febc7312b522a.jpg",
            "emblemBackgroundPath": "https://bungie.net/common/destiny2_content/icons/f4db2825bf1c3d2afd3fe3436533e377.jpg",
            "emblemHash": 131450130,
            "emblemColor": {
                "red": 0,
                "green": 0,
                "blue": 0,
                "alpha": 255
            },
            "levelProgression": {
                "progressionHash": 1716568313,
                "dailyProgress": 0,
                "dailyLimit": 0,
                "weeklyProgress": 0,
                "weeklyLimit": 0,
                "currentProgress": 0,
                "level": 50,
                "levelCap": 50,
                "stepIndex": 50,
                "progressToNextLevel": 0,
                "nextLevelAt": 0
            },
            "baseCharacterLevel": 50,
            "percentToNextLevel": 0,
            "titleRecordHash": 3137935313
        },
        "2305843009302904780": {...},
        "2305843009313535740": {...}
    },
    "AccessLevel": "premium"
}

Permet de récupérer la liste complète des récompenses spéciales (emblèmes, emotes, transmat, shaders) distribuées par Bungie via des codes promotionnels, avec leurs détails et leur statut de possession.

• Le paramètre guardian est optionnel. Il doit contenir l’ID d’un gardien Destiny 2.
• Le paramètre type est également optionnel et correspond au type de compte Bungie :
  • 1 : Xbox
  • 2 : PlayStation
  • 3 : Steam (par défaut si non précisé)
  • 4 : Battle.net
  • 5 : Stadia
  • 6 : Epic Games
• L’endpoint retourne, pour chaque catégorie de récompense :
  • Le code d’activation
  • La description et la collectibleHash
  • Les données issues du manifest Bungie : nom, icône principale, icône secondaire
  • Et si un identifiant de gardien est fourni : le statut owned (booléen) et le state complet
• Si aucun gardien n’est précisé, les champs owned et state sont renvoyés à null.
• Le contenu est toujours enrichi depuis le manifest Destiny 2 afin d’inclure les visuels et les noms, même sans identifiant de gardien.

{
    "success": true,
    "guardian": "4611686018467190713",
    "membershipType": 3,
    "emblems": [
        {
            "id": "1968995954",
            "code": "JXJ-HVA-RCX",
            "info": "Distributed by Bungie via social media channels on 2025-05-01 in the lead up to the Edge of fate reveal stream.",
            "collectibleHash": 2006613212,
            "name": "Ever Forward",
            "icon": "https://bungie.net/common/destiny2_content/icons/16f8a7bf9b5d5fe45a564803ec1dbaf7.jpg",
            "secondaryIcon": "https://bungie.net/common/destiny2_content/icons/db147af2f8220f792c1cfb249115b7c5.jpg",
            "owned": true,
            "state": 0
        },
        {
            "id": "1935440659",
            "code": "JGN-PX4-DFN",
            "info": "Discovered as part of the Aion Archives ARG in late April 2025.",
            "collectibleHash": 2040168509,
            "name": "Secret Signal",
            "icon": "https://bungie.net/common/destiny2_content/icons/01717fdf550c6dc498bf41ede84c190d.jpg",
            "secondaryIcon": "https://bungie.net/common/destiny2_content/icons/e2b43875a5f769e79a59fb0aa111cda8.jpg",
            "owned": true,
            "state": 0
        },
        {...}
    ],
    "emote": [
        {
            "id": "1063785104",
            "code": "TK7-D3P-FDF",
            "info": "Released during Pride Month",
            "collectibleHash": null,
            "name": "Rainbow Connection",
            "icon": "https://bungie.net/common/destiny2_content/icons/6b11266fcdb8e1e8bb8965724e1bfe20.jpg",
            "secondaryIcon": null,
            "owned": null,
            "state": null
        }
    ],
    "transmat": [
        {
            "id": "3549689934",
            "code": "R9J-79M-J6C",
            "info": "Released during Pride Month",
            "collectibleHash": 1009936720,
            "name": "End of the Rainbow",
            "icon": "https://bungie.net/common/destiny2_content/icons/ac741348c625bc6a6efe1bcebda3c48d.jpg",
            "secondaryIcon": null,
            "owned": true,
            "state": 64
        }
    ],
    "shader": [
        {
            "id": "4182403848",
            "code": "D6T-3JR-CKX",
            "info": "Released during Pride Month",
            "collectibleHash": 1656083080,
            "name": "Prismatic Expanse",
            "icon": "https://bungie.net/common/destiny2_content/icons/ef40ec9f65218df89d1de81112a80820.jpg",
            "secondaryIcon": null,
            "owned": true,
            "state": 64
        }
    ],
    "AccessLevel": "premium"
}