Platzi
Platzi

Suscr铆bete a Expert y aprende de tecnolog铆a al mejor precio anual.

Antes: $249
$209
Currency
Antes: $249
Ahorras: $40
COMIENZA AHORA
Termina en: 9D : 18H : 17M : 30S

Blizzard Developer Portal3/27

Lectura

En esta secci贸n vamos a explicar algunos conceptos del portal de desarrolladores de Blizzard que vamos a necesitar para el desarrollo de nuestra app.

Main

Este es el portal oficial de desarrolladores de Blizzard. Aqu铆 encontrar谩s toda la informaci贸n necesaria.

馃摋 https://develop.battle.net/

Crear Cuenta

馃摋 https://us.battle.net/account/creation/es/

Para poder usar las APIs de Blizzard es necesario crearse una cuenta. Crea tu cuenta desde el siguiente enlace: https://us.battle.net/account/creation/es/

Blizzard Authenticator

Una vez hayas creado tu cuenta, el siguiente paso es que te instales en el m贸vil la aplicaci贸n 鈥淏lizzard Authenticator鈥.
El Authenticator de Blizzard es obligatorio y ofrece una capa extra de seguridad contra accesos no autorizados a tu cuenta.

Descarga la aplicaci贸n Blizzard Authenticator de la App Store o desde Google Play para continuar.

Uso

Cuando entres a tu cuenta, recibir谩s una solicitud de autenticaci贸n en tu equipo. Si el c贸digo de tu equipo es el mismo que el de tu ordenador, presiona Aprobar.

Abre la aplicaci贸n de Blizzard Authenticator, ver谩s algo parecido a esto:
mobile-1

Desde el formulario de iniciar sesi贸n, pon tu usuario y tu contrase帽a. Antes de terminar el inicio de sesi贸n, te pedir谩n que confirmes el acceso
auth-1

Ahora, en la app Blizzard Authenticator, te aparecer谩 el c贸digo. Pulsa el bot贸n de 鈥淎utorizar鈥
mobile-2

Una vez que hayas aceptado desde la app en tu tel茅fono m贸vil ver谩s algo como esto:
auth-2

Seguridad

Si inicias sesi贸n siempre desde la misma ubicaci贸n, puede que no se te pida un c贸digo de Authenticator. Esto permite iniciar sesi贸n m谩s r谩pido cuando te encuentras en una ubicaci贸n segura.

Si recibes una solicitud de autenticaci贸n que no hayas iniciado, haz clic en Denegar y cambia tu contrase帽a de Blizzard.


Client Credentials Flow

馃摋 https://develop.battle.net/documentation/guides/using-oauth/client-credentials-flow

Para consumir las APIs de Diablo III (o cualquier otro juego de Blizzard) es necesario previamente haber obtenido un token de acceso, que a partir de ahora lo llamaremos el 鈥渢oken鈥. El token de acceso es una credencial usada para acceder a los recursos protegidos de la API. Este tipo de flujo, el flujo 鈥淐lient Credentials Flow鈥 se usa para la mayor铆a de las solicitudes a las APIs de Blizzard.

Cuando entras en la aplicaci贸n (https://diablo3.netlify.com/), lo primero que ves es un 鈥淟oading鈥. Eso es porque la aplicaci贸n est谩 obteniendo el token. M谩s adelante entender谩s c贸mo se hace.

Loading

Puedes ver el RFC de OAuth si quieres saber m谩s acerca del 鈥淐lient Credentials Flow鈥

Regiones

馃摋 https://develop.battle.net/documentation/guides/regionality-and-apis

Blizzard emplea varios conceptos basados en la regi贸n para administrar y servir los datos de los juegos.

Los datos de las APIs est谩n limitados a regiones espec铆ficas. Por ejemplo, las APIs de Europa (eu) a las que se acceden a trav茅s de eu.battle.net solo contienen datos de grupos de batalla y reinos de Europa.

En este caso nos vamos a centrar en las regiones para Diablo III. Puede ser que esta informaci贸n cambie para otros juegos como Starcraft o WoW.
Las regiones y los datos a los que tienen acceso son los siguientes:

Regi贸n Datos
US Battle.net, WoW, D3, SC2
EU Battle.net, WoW, D3, SC2
KR Battle.net, WoW, D3, SC2
TW Battle.net, WoW, D3, SC2
CN Battle.net, WoW, D3, SC2

Aunque estas son todas las regiones que podemos utilizar, la regi贸n de China (CN) no la vamos a usar en nuestra aplicaci贸n. Tiene un funcionamiento distinto al resto de las regiones. Por eso, para este curso la dejaremos de lado.

Diablo III APIs

Diablo III nos ofrece dos tipos de APIs, que tienen URLs diferentes y usaremos de forma distinta en nuestra aplicaci贸n.

En este curso, construir谩s la aplicaci贸n de D3PF utilizando estos dos tipos de APIs. Gu谩rdate los enlaces a la documentaci贸n de las APIs, pues las usaremos a menudo para consultar c贸mo se traen los datos, par谩metros requeridos, etc.

APIs de comunidad

Las APIs de comunidad de Diablo III, nos van a traer datos del perfil del usuario que estemos buscando, como por ejemplo, los h茅roes que tiene o 茅lites que ha matado a lo largo del tiempo.

Consulta la informaci贸n detallada aqu铆: https://develop.battle.net/documentation/diablo-3/community-apis

APIs de datos

A trav茅s de las APIs de datos del juego de Diablo III, podemos obtener informaci贸n sobre las temporadas, los rankings y las eras (las eras son parecidas a las temporadas, un espacio temporal limitado)

馃摋 Consulta la informaci贸n detallada aqu铆: https://develop.battle.net/documentation/diablo-3/game-data-apis

Acceso a las APIs: Clientes

Para poder consumir las APIs de Diablo III, como ya sabes, vas a necesitar un token. Dicho token es el resultado de hacer una llamada http de tipo POST a un servidor de Blizzard con unos par谩metros espec铆ficos.
Lo que nos devuelva dicha llamada ser谩, si todo ha ido bien, el token. Una vez que tengamos el token, lo guardaremos en nuestra aplicaci贸n de forma temporal. Y cada vez que hagamos una llamada a una API del juego usaremos este token.

Para poder obtener el token, vas a tener que crear un cliente. Deber铆as crear un cliente por cada aplicaci贸n, no utilices el mismo cliente en varias aplicaciones.

Crea tu cliente de acceso a APIs desde este enlace: https://develop.battle.net/access/clients/create

Formulario

Rellena el formulario y dale a crear:

  • Client Name: te va a servir para identificar los distintos clientes que tengas. Puedes poner, por ejemplo, 鈥淒3PF鈥 que es el nombre de la app.
  • Redirect URIs: Este campo no lo vamos a usar por el tipo de flujo OAuth que estamos usando.
  • Service URL: De momento lo dejas en blanco. No te olvides de marcar el checkbox de 鈥淚 do not have a service URL for this client.鈥 Cuando tengas tu app subida en la nube, deber谩s volver a editar la informaci贸n de este cliente y actualizar este campo.
  • Intended Use: 驴Para qu茅 lo vas a usar? 驴C贸mo lo vas a usar? Responde a estas preguntas.
    Para el caso de esta app puedes poner algo parecido a esto: 鈥Try the new apis and provide players information about their D3 characters鈥, que significa que vas a usar las APIs para 鈥減robar las nuevas APIs y proporcionar informaci贸n sobre los personajes de D3鈥

Una vez se haya creado, deber铆as ver algo parecido a esto:
Client

Durante este curso, aprender谩s a obtener un token de acceso de los servidores de Blizzard. Para ello, vas a usar el clientID y el clientSecret.

No compartas tu clienteSecret con nadie, intenta guardarlo en un lugar seguro.
M谩s adelante ver谩s un posible m茅todo para tener estos datos de forma privada, pero accesibles desde la aplicaci贸n. 驴C贸mo te imaginas que lo haremos?

Todos los clientes tienen unos l铆mites a la hora de consumir APIs. Para evitar sobrecargas en los servidores, las APIs tienen las siguientes restricciones:

  • Cuota a largo plazo: 36,000 peticiones por hora
  • Cuota a corto plazo: 100 peticiones por segundo

Puedes gestionar todos tus clientes desde aqu铆: https://develop.battle.net/access/clients


Antes de pasar a la siguiente lectura deber铆as haber creado tu cliente y tener tu ClientId y tu ClientSecret.

隆Perfecto! Ya tienes todo lo necesario para empezar a darle forma a la app en Vue. 隆Dejemos la teor铆a de lado y empecemos a picar c贸digo!

Aportes 16

Preguntas 0

Ordenar por: