API:2/masteries

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/masteries

HTTP method
GET
Format
json
API version
version 2
Release date
2016-09-26
Scope
none
Optional
none

This resource returns information about masteries that are available in-game.

Endpoints

  • None - Request the list of all available mastery ids.
  • id - (Optional) Request the mastery for the specified id. Cannot be used when specifying the ids parameter.

Parameters

  • lang – (Optional) Request localized information.
  • ids - (Optional; Comma Delimited List|all) Request an array of masteries for the specified ids or all masteries. Cannot be used when accessing the id endpoint.

Response

For each requested mastery id, an object with the following properties is returned:

  • id (integer) (default/null value: 0) - The id of the mastery.
  • name (string) (default/null value: "") - The name of the selected mastery.
  • requirement (string) (default/null value: "") - The written out requirements to unlock the mastery track.
  • order (integer) (default/null value: 0) - The order in which the mastery track appears in a list.
  • background (string) (default/null value: "") - The background uri for the mastery track.
  • region (string) (default/null value: "") - The in-game region in which the mastery track belongs.
  • levels (array) - An array containing the information of each mastery level.
    • name (string) (default/null value: "") - The name for the given mastery.
    • description (string) (default/null value: "") - The in game description for the given mastery.
    • instruction (string) (default/null value: "") - The in game instructions for the given mastery.
    • icon (string) (default/null value: "") - The icon uri for the mastery.
    • point_cost (integer) (default/null value: 0) - The amount of mastery points required to unlock the mastery.
    • exp_cost (integer) (default/null value: 0) - The total amount of experience needed to train the given mastery level. This total is non-cumulative between levels.

Example

https://api.guildwars2.com/v2/masteries

[
   1,
   2,
   3,
   4,
   5,
   6,
   8,
   12,
   13
]

https://api.guildwars2.com/v2/masteries/1

 {
   "id": 1,
   "name": "Exalted Lore",
   "requirement": "Journey to Auric Basin to unlock the Exalted Lore Mastery track.",
   "order": 2,
   "background": "https://render.guildwars2.com/file/4E09B60E16E6A7404B0638A00D0C6A02F7294308/1228720.png",
   "region": "Maguuma",
   "levels": [
       {
           "name": "Exalted Markings",
           "description": "Gain the knowledge to read Exalted markings. You can now decipher their words and gain access to secrets of their civilization.",
           "instruction": "You can now interact with Exalted artifacts found in Auric Basin and the greater Maguuma Jungle.",
           "icon": "https://render.guildwars2.com/file/7372DCB5085D75F672B50CB8F3577373B8F90468/1228654.png",
           "point_cost": 1,
           "exp_cost": 508000
       },
       {...},
       {
           "name": "Exalted Gathering",
           "description": "Learn from the Exalted how to gather rare materials around the Maguuma Jungle. Learn to mine up Auric Slivers from ore nodes in Auric Basin.",
           "instruction": "When mining ore while in Auric Basin, you will gain Auric Slivers in addition to normal materials. You also have a chance to mine special items from ore nodes all around the Heart of Maguuma.",
           "icon": "https://render.guildwars2.com/file/324312530AA1A427AB0951D0BFBC92C4B69774D6/1228653.png",
           "point_cost": 8,
           "exp_cost": 3302000
       }
   ]
 }

https://api.guildwars2.com/v2/masteries?ids=1,2&lang=fr

 [
   {
       "id": 1,
       "name": "Ethnologie des Exaltés",
       "requirement": "Rendez-vous dans le Bassin aurique pour déverrouiller le parcours de maîtrise Ethnologie des Exaltés.",
       "order": 2,
       "background": "https://render.guildwars2.com/file/4E09B60E16E6A7404B0638A00D0C6A02F7294308/1228720.png",
       "region": "Maguuma",
       "levels": [
           {
               "name": "Marques exaltées",
               "description": "Apprendre à lire les marques exaltées. Vous pouvez à présent déchiffrer leurs mots et avoir accès aux secrets de leur civilisation.",
               "instruction": "Vous pouvez désormais interagir avec les artefacts exaltés trouvés dans le Bassin aurique et la Jungle de Maguuma.",
               "icon": "https://render.guildwars2.com/file/7372DCB5085D75F672B50CB8F3577373B8F90468/1228654.png",
               "point_cost": 1,
               "exp_cost": 508000
           },
           {...},
           {
               "name": "Récolte exaltée",
               "description": "Apprenez à récupérer les matériaux rares de la Jungle de Maguuma grâce aux Exaltés. Découvrez comment extraire les esquilles auriques des zones de minerai du Bassin aurique.",
               "instruction": "En récoltant du minerai dans le Bassin aurique, vous obtiendrez des esquilles auriques en plus des matériaux ordinaires. Vous avez également plus de chances de récolter des objets spéciaux sur les zones de minerai du Cœur de Maguuma.",
               "icon": "https://render.guildwars2.com/file/324312530AA1A427AB0951D0BFBC92C4B69774D6/1228653.png",
               "point_cost": 8,
               "exp_cost": 3302000
           }
       ]
   },
   {
       "id": 2,
       "name": "Ethnologie des Itzels",
       "requirement": "Entraînez la maîtrise Principes du deltaplane dans le parcours de maîtrise Vol en deltaplane pour déverrouiller le parcours de maîtrise Ethnologie des Itzels.",
       "order": 1,
       "background": "https://render.guildwars2.com/file/F2ED9E6B330AA015B8AD06FF222715284E1BC622/1228723.png",
       "region": "Maguuma",
       "levels": [
           {
               "name": "Champignons rebondissants",
               "description": "Apprenez à atterrir au bon endroit et à utiliser les champignons rebondissants du Cœur de Maguuma pour atteindre des endroits inaccessibles autrement.",
               "instruction": "Les champignons rebondissants sont dispersés dans tout le Cœur de Maguuma. Montez dessus puis sautez pour être projeté dans les airs.",
               "icon": "https://render.guildwars2.com/file/C1D5574EF6B9B4CC7AB7EC3600993698D39BF975/1228645.png",
               "point_cost": 1,
               "exp_cost": 508000
           },
           {...},
           {
               "name": "Champignons surrénaux",
               "description": "Apprendre à manger ces champignons agit sur votre sécrétion d'adrénaline, vous procurant une poussée d'adrénaline et rafraîchissant instantanément vos compétences.",
               "instruction": "Les champignons surrénaux sont plutôt difficiles à trouver dans le Cœur de Maguuma. Passez près de l'un d'eux pour rafraîchir toutes vos compétences.",
               "icon": "https://render.guildwars2.com/file/EB50DAD5409C937CD17A0A216A7B3E04E0C25307/1228643.png",
               "point_cost": 12,
               "exp_cost": 4318000
           }
       ]
   }
 ]