API

De GuildWiki2.es
Saltar a: navegación, buscar

La API de Guild Wars 2 (application programming interface) es una interfaz que permite el acceso de programas de terceros directamente a los datos de los servidores de Guild Wars 2. Los terminos de uso API asi como información adicional y colaboración entre desarrolladores puede encontrarse en los foros oficilales.

En su primera versión, la API es de acceso público a través de HTTPS y no requiere autorización. Todos los recursos son accesibles a través de GET y los parámetros se suministran en forma de parámetros de cadena de consulta. La API devuelve respuestas en forma de JSON.

La URL para todas la peticiones API listadas a continuación es https://api.guildwars2.com. Librerías para diferentes lenguajes puede encontrarse en API/Librerías.

Contenido

General

Lenguajes soportados

Muchas de las APIs soportan un parámetro lang opcional. Los posibles valores para este parámetro son los códigos de lenguaje soportados: es, fr, en, de. El valor por defecto es en.


Nombres de mundos y mapas 

GET /v1/world_names.json
GET /v1/map_names.json
Parámetros opcionales
  • lang – El idioma para consultar los nombres.

Estos recursos devuelven una lista desordenada de los nombres de mundo o mapa localizados. Cada entrada contiene la id del mundo o mapa y el nombre localizado.

Ejemplo

https://api.guildwars2.com/v1/world_names.json?lang=es 

 [
   {"id":"1001","name":"Roca del Yunque"},
   {"id":"1013","name":"Sagrario de Rall"},
   {"id":"1016","name":"El Mar de los Pesares"},
   ...
 ]

Eventos dinámicos

Estado de los eventos 

GET /v1/events.json
Parámetros opcionales
  • world_id – Sólo una lista de eventos de ese mundo.
  • map_id – Sólo una lista de los acontecimientos en ese mapa.
  • event_id – Sólo una lista de este evento.

Este recurso devuelve una lista de los eventos que coinciden con el filtro dado. Cada evento contiene el ID mundo y el ID del mapa que se está llevando a cabo en un ID de evento único y el estado actual del evento. Los siguientes estados de eventos son posibles:

  • Active – El evento se está ejecutando ahora.
  • Success – El evento ha tenido éxito.
  • Fail – El evento ha fallado.
  • Warmup – El evento está inactivo, y sólo se activa una vez que se cumplen ciertos criterios.
  • Preparation – Se han cumplido los criterios para empezar el evento, pero ciertas actividades (como el diálogo de un Personaje_no_jugador PNJ) no han finalizado todavía. Después de que las actividades se han completado, el evento se convertirá en activo.
  • Invalid - El evento no se está ejecutando.
Ejemplo

https://api.guildwars2.com/v1/events.json?world_id=2301&map_id=39 

 {
   "events": [
     { "world_id": 2301, "map_id": 39, "event_id": "2875FBFE-668E-438A-8CE7-A4BCF2EF0175", "state": "Warmup" },
     { "world_id": 2301, "map_id": 39, "event_id": "E0D7E88D-4FF6-42FA-AFFC-0DF4111C2CCD", "state": "Active" },
     { "world_id": 2301, "map_id": 39, "event_id": "831DC6FB-5F63-4B0C-96A5-FE2037EBEE7F", "state": "Active" },
     { "world_id": 2301, "map_id": 39, "event_id": "C6EFB827-EABC-4100-A6FE-97C7D9275CEC", "state": "Active" },
     ...
   ]
 }

Nombres de los eventos 

GET /v1/event_names.json
Parámetros opcionales
  • lang – El idioma para consultar los nombres.

Este recurso devuelve una lista desordenada de los nombres de los eventos localizados para el idioma especificado. Cada entrada contiene el identificador de evento y el nombre del evento localizado.

Ejemplo

https://api.guildwars2.com/v1/event_names.json?lang=es 

 [
   {"id":"15430A64-72EB-44D1-B788-77B604818F8A","name":"Libera el Fuerte de Shaemoor."},
   {"id":"1F3BECEF-09FC-4DB9-9D64-45131E819C54","name":"Defiende el santuario de Jora de los Hijos de Svanir."},
   ...
 ]

Mundo contra mundo

Partidas 

GET /v1/wvw/matches.json

Este recurso devuelve una lista de las partidas mcm actualmente en ejecución, con los mundos participantes incluidos en el resultado. Más detalles acerca de un partido se puede solicitar con los ejemplos citados a continuación.

Ejemplo

https://api.guildwars2.com/v1/wvw/matches.json 

 {
   "wvw_matches": [
     { "wvw_match_id": "2-6", "red_world_id": 2006, "blue_world_id": 2205, "green_world_id": 2102 },
     { "wvw_match_id": "1-4", "red_world_id": 1011, "blue_world_id": 1014, "green_world_id": 1016 },
     { "wvw_match_id": "1-2", "red_world_id": 1009, "blue_world_id": 1017, "green_world_id": 1021 },
     ..
   ]
 }

Detalles de las partidas 

GET /v1/wvw/match_details.json?match_id=<match_id>
Parametros requeridos
  • match_id – La partida a consultar.

Este recurso devuelve detalles sobre la partida especificada, incluyendo la puntuación total y detalles de cada mapa. Cada mapa es identificado por el color "home" de las Tierras fronterizas o "center" para los Campos de Batalla Eternos), enumera la puntuación local y una lista con el estado de cada objetivo en el mapa. Cada objetivo indica el color del dueño, y si el objetivo es reclamado por un clan, también la identificación del clan que lo reclama.

Ejemplo

https://api.guildwars2.com/v1/wvw/match_details.json?match_id=1-4 

 {
   "match_id": "1-4",
   "scores": [ 145529, 154561, 228909 ],
   "maps": [
     {
       "type": "RedHome",
       "scores": [ 80451, 16201, 17716 ],
       "objectives": [
         { "id": 32, "owner": "Blue" },
         { "id": 36, "owner": "Blue", "owner_guild": "D724F1BD-569B-497B-AEC2-CFEBDA060619" },
         ...
       ]
     },
     {
       "type": "GreenHome",
       "scores": [ 8387, 10488, 94123 ],
       "objectives": [ ... ]
     },
     {
       "type": "BlueHome",
       "scores": [ 13736, 83861, 16782 ],
       "objectives": [ ... ]
     },
     {
       "type": "Center",
       "scores": [ 42955, 44011, 100288 ],
       "objectives": [ ... ]
     }
   ]
 }

Nombres objetivo 

GET /v1/wvw/objective_names.json
Parámetros opcionales
  • lang – El idioma para consultar los nombres.

Este recurso devuelve una lista desordenada de los nombres de objetivos localizados para el idioma especificado. Cada entrada contiene el identificador del objetivo y el nombre del objetivo localizado.

Ejemplo

https://api.guildwars2.com/v1/wvw/objective_names.json?lang=es 

 [
   { "id": "30", "name":"Torre" },
   { "id": "9", "name":"Castillo" },
   { "id": "32", "name":"Fortaleza" },
   ...
 ]

Objetos

Objetos descubiertos 

GET /v1/items.json

Este recurso devuelve una lista de todos los objetos que han sido descubiertos por los jugadores.

Ejemplo

https://api.guildwars2.com/v1/items.json 

 {
   "items": [
     12546,
     38875,
     26706,
     ...
   ]
 }

Detalles del objeto 

GET /v1/item_details.json?item_id=<item_id>
Parámetros requeridos
  • item_id – El objeto a consultar.
Parámetros opcionales
  • lang – El idioma de la consulta.

Este recurso devuelve detalles del objeto en el idioma especificado. El formato de los datos devueltos depende del tipo de elemento. Algunos aspectos de los detalles de los elementos estarán presentes en todo tipo de objeto, mientras que algunos otros serán específicos para determinados tipos de objeto.

Ejemplo

https://api.guildwars2.com/v1/item_details.json?item_id=30686&lang=es 

 {
   "item_id": "30686",
   "name": "El Soñador",
   "description": "",
   "type": "Weapon",
   "level": "80",
   "rarity": "Legendary",
   "vendor_value": "100000",
   "game_types": [ "Activity", "Dungeon", "Pve", "Wvw" ],
   "flags": ["HideSuffix","NoSell","SoulBindOnUse"]
   "restrictions": [],
   "weapon": {
     "type": "ShortBow",
     "damage_type": "Physical",
     "min_power": "905",
     "max_power": "1000",
     "defense": "0",
     "infusion_slots": [],
     "infix_upgrade": {
       "buff": "",
       "attributes": [
         { "attribute": "Power", "modifier": "179" },
         { "attribute": "Toughness", "modifier": "128" }
         { "attribute": "Vitality", "modifier": "128" }
       ]
     },
     "suffix_item_id": "24571"
   }
 }

Ver API/Detalles de objetos para el marco completo de detalles.

Recetas

Recetas descubiertas 

GET /v1/recipes.json

Este recurso devuelve una lista de todas las recetas que han sido descubiertas en el juego.

Ejemplo

https://api.guildwars2.com/v1/recipes.json 

 {
   "recipes": [
     1275,
     3147,
     ...
   ]
 }

Detalles de la receta 

GET /v1/recipe_details.json?recipe_id=<item_id>
Parámetros requeridos
  • recipe_id – La receta a consultar.
Parámetros opcionales
  • lang – El idioma de la consulta.

Este recurso devuelve información acerca de la receta indicada. Tenga en cuenta que si bien el establecimiento de un idioma está soportado, no tendrá ningún efecto ya que los datos no contienen ningún contenido localizable y el elemento creado se documenta mediante el output_item_id en su lugar.

Ejemplo

https://api.guildwars2.com/v1/recipe_details.json?recipe_id=1275 

 {
   "recipe_id": "1275",
   "type": "Coat",
   "output_item_id": "11541",
   "output_item_count": "1",
   "min_rating": "25",
   "time_to_craft_ms": "1000",
   "ingredients": [
     { "item_id": "19797", "count": "1" },
     { "item_id": "13094", "count": "1" },
     { "item_id": "13093", "count": "1" }
   ]
 }

Ver API/Detalles de recetas para el marco completo de detalles.

Miscelánea

Detalles de los clanes 

GET /v1/guild_details.json?guild_id=<guild_id>

Este recurso devuelve los detalles del clan especificado mediante dos opciones, nombre o id del clan.

Parámetros requeridos
guild_id – ID del clan
guild_name – Nombre o tag del clan
Valores devueltos
guild_id
guild_name
tag
emblem – Detalles para la generación del logo de gremio:
background_id – ID de la imagen de fondo
foregrund_id – ID de la imagen en primer plano
flags – []
background_color_id – ID del color de fondo
foreground_primary_color_id – ID del color de fondo primario
foreground_seconday_color_id – ID del color de fondo secundario
Ejemplo

https://api.guildwars2.com/v1/guild_details.json?guild_id=75FD83CF-0C45-4834-BC4C-097F93A487AF 

 {
  guild_id: "75FD83CF-0C45-4834-BC4C-097F93A487AF",
  guild_name: "Veterans Of Lions Arch",
  tag: "LA",
  emblem: {
    background_id: 27,
    foreground_id: 114,
    flags: [ ],
    background_color_id: 11,
    foreground_primary_color_id: 584,
    foreground_secondary_color_id: 64
  }
 }

Colores 

GET /v1/colors.json
Parámetros opcionales
  • lang – El idioma de la consulta.

Devuelve todos los colores / tintes en el juego, y su información de componente de color. Los colores se representan en su forma de color cambiante original (HSL + contraste / brillo), así como en forma RGB.

Ejemplo

https://api.guildwars2.com/v1/colors.json?lang=es 

 {
  colors: {
    668: {
      name: "Hielo rosado",
      base_rgb: [ 128, 26, 26 ],
      cloth: {
        brightness: 50,
        contrast: 1.36719,
        hue: 8,
        saturation: 0.351563,
        lightness: 1.36719,
        rgb: [ 216, 172, 164 ]
      },
      leather: {
        brightness: 47,
        contrast: 1.71875,
        hue: 8,
        saturation: 0.234375,
        lightness: 1.71875,
        rgb: [ 207, 170, 163 ]
      },
      metal: {
        brightness: 47,
        contrast: 1.64063,
        hue: 8,
        saturation: 0.429688,
        lightness: 1.48438,
        rgb: [ 211, 145, 134 ]
      }
    },
    ...
  }
 }
Ejemplo en funcionamiento

Notas

  • Los identificadores de mundo que comienzan por 1 son de América del Norte, mientras que los que comienzan por 2 son de Europa.
  • Inglés Inglés: API.
Obtenido de «http://www.guildwiki2.es/w/index.php?title=API&oldid=27916»
Herramientas personales
Espacios de nombres

Variantes
Acciones
Navegación
Herramientas
Compartir
Publicidad