Probando con Javascript

Javascript

Probamos nuestra Key de Marvel API Developer

En nuestro post anterior, nos enfocamos en obtener la Key de Developer para Marvel API Developmet

Ya tenemos nuestra Key de Developer en Marvel ¿Y ahora que podemos hacer?

La forma más rápida para probar la API es directamente desde el centro de development de Marvel:

A continuación elegimos "Test Calls" que nos dice:

"Use the interactive test page to explore and test API calls."

Y vemos la siguiente pantalla que nos permite explorar la API:

Hablando técnica y resumidamente, tenemos una API Rest pública, que podemos acceder utilizando el método GET de HTTP y la respuesta es contenido Json, el cual podemos manipular para armar lo que estemos buscando armar.

Observemos al primero de los servicios invocados.

Hay que notar que la prueba de la invocación a los servicios de la API Rest de Marvel que voy a realizar a continuación es con una sesión iniciada. O sea que la Key de Developer es enviada con cada petición que realice a la API, y por ese mismo motivo los servicios REST responderán con información:

GET /v1/public/characters

Este servicio, retornará los characters o personajes: buscaremos a "Iron Man" a ver que pasa:

Completamos únicamente el nombre "Iron Man" aunque el servicio ofrece multitud de filtros:

Observemos una parte de la documentación de la API:

Y mas abajo completamos únicamente el nombre del character o personaje que buscamos:
nombre: Iron Man

Observar que el tipo de respuesta es Json:

Seguimos, y observamos que con el botón "Try It Out" lanzamos la invocación al servicio:

Y el resultado es excelente: 

a) Funcionó desde el primer intento!

b) Pusimos el nombre "Iron Man" y ya descubrimos algunas cosas interesantes:

• El ID de Iron Man es: 1009368
• Su historia es:

"Wounded, captured and forced to build a weapon by his enemies, billionaire industrialist Tony Stark instead created an advanced suit of armor to save his life and escape captivity. Now with a new outlook on life, Tony uses his money and intelligence to make the world a safer, better place as Iron Man "

Y podemos encontrar una foto de Iron Man en: 

http://i.annihil.us/u/prod/marvel/i/mg/9/c0/527bb7b37ff55.jpg

Que es la imagen que vemos a continuación:

Hemos logrado alcanzar de forma muy satisfactoria el primer objetivo de probar nuestra Key de Developer de Marvel, y consumir uno de los servicios.

Con lo cual podemos dar por finalizado este primer post.

En el siguiente post trataremos de hacer alguna exploración del uso de la API con Javascript.



Data provided by Marvel. © 2014 Marvel

Obteniendo la Key de Marvel API Developer

¿Que es la Key de developer y para que la necesito?

Para dar una respuesta sencilla, si quiero hacer una aplicación web o móvil que invoque a los servicios de Marvel, necesito tener una Key de developer. 

En busca de esa key, en el post anterior primero nos registramos en Marvel y hoy vamos continuar el proceso:

Vamos a developer.marvel.com

Elegimos "Get a Key"

Y nos logoneamos con la cuenta Marvel que acabamos de crear:

En este punto podemos hacer dos cosas:

• Aceptamos los términos y condiciones sin leer
• Leer primero y aceptar después

Vamos a superar la tentación de aceptar sin leer para averiguar que restricciones tenemos:

• Sin publicidad: Las aplicaciones que generemos no pueden tener publicidad (excepto publicidades provistas por Marvel)
• Sin costo: Las aplicaciones que hagamos no las podemos vender (excepto que Marvel lo apruebe explícitamente)

Y otras mas predecibles denominadas:
ATTRIBUTION, LINKING AND RATE LIMITS

• ATTRIBUTION: Debemos atribuir a Marvel el contenido que mostramos a través del API.
• LINKING: Debemos Agregar Links a Marvel si mostramos imágenes grandes.
• RATE LIMITS: La cantidad de datos que podemos extraer desde la API es limitado.

Y algunas otras reglas mas, por ejemplo, no hacer cache del contenido indefinidamente.

Consideramos que las reglas son completamente coherentes con el modelo de negocio de Marvel y sus derechos. Por lo cual, damos acepar a los términos y condiciones del uso de la Api de desarrollo de Marvel

Y pasamos a la pantalla siguiente donde tenemos la API y nos dice que tenemos permitidas una tasa de 3000 llamadas diarias a la API

 Obtenemos de esta manera la API de desarrollador y estamos en condiciones de hacer nuestra primera prueba. ¿Pero que probamos?

En el siguiente post justamente lo vamos a dedicar a Probar la API de Marvel

Hola Mundo Marvel API Developer: Creando la cuenta

Marvel API Developer

Acabo de descubrir algo que me sorprendido mucho y que realmente me resulta muy interesante desde el punto de vista de las posibilidades que ofrece  para los que nos gusta desarrollador aplicaciones:

La API de Marvel para desarrollo:

http://developer.marvel.com/

O sea, Marvel ofrece una API que nos permite crear aplicaciones sobre ella.

Para ello es necesario registrarse, y obtendremos una Key de desarrollo que nos permitirá hacer uso de la API:

Empecemos entonces, Completamos el formulario:

Después tenemos que confirmar el mail que nos envían:

Después de confirmar el mail accedo a mi cuenta:

Ya estamos registrados con una cuenta en Marvel, pero todavía nos falta encontrar la key de developer

En el siguiente post vamos ver como obtener la cuenta de developer.