API:2/gliders

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/gliders

HTTP method
GET
Format
json
API version
version 2
Release date
2017-03-15
Scope
none
Optional
none

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

Endpoints

  • None - Request the list of all available glider ids when the root endpoint (v2/gliders) has been accessed.
  • id - (Optional) Request the glider for the specified id when accessing the endpoint (v2/gliders/id). Cannot be used when specifying the ids parameter.

Parameters

  • lang – (Optional) Request localized information. See note [1].
  • page - (Optional; integer)
  • page_size - (Optional; integer)
  • ids - (Optional; Comma Delimited List|all) Request an array of gliders for the specified ids or all gliders. Cannot be used when accessing the id endpoint.

Response

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

  • id (integer) (default/null value: 0) - The id of the glider.
  • unlock_items (array of numbers) (optional) - An array of item ids used to unlock the glider. Can be resolved against v2/items
  • order (integer) (default/null value: 0) - The order in which the glider appears in a list. This value is not unique.
  • icon (string) (default/null value: "") - The icon uri for the glider.
  • name (string) (default/null value: "") - The name of the glider as it appears in-game.
  • description (string) - The in-game glider description.
  • default_dyes (array of numbers) - List of dye ids. Can be resolved against v2/colors.

Example

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

{
   "id": 1,
   "unlock_items": [
       70048
   ],
   "order": 3,
   "icon": "https://render.guildwars2.com/file/5978F84C08E69460B7FD34346745E7183562A35A/951784.png",
   "name": "Black Feather Wings Glider",
   "description": "<c=@reminder>This is only available from the Black Lion Trading Company during limited-time sales.</c>\n\nIf you wear the Black Feather Wings Backpack, speak to a scout in Verdant Brink to receive a free matching Glider.",
   "default_dyes": [ ]
 }

Notes

  1. ^
    Differently from usual, the lang parameter has no effect. The result will still be in English.