Minerva es un índice de contenidos pensado para consumir sus datos por otros servicios, algunos de ellos los publicaremos nosotros.
Sin embargo la API es de pública y también podéis usarla para vuestras propias páginas webs, aplicaciones, etc. De momento no es necesario adquirir ninguna AppID para utilizarla, y así será mientras no sea un problema para los servidores.
Aunque me gustaría haber publicado una guía más completa de la API, por problemas de última hora con el autogenerador tendréis que conformaros con las pequeñas notas que aquí os dejo y experimentar por vuestra cuenta. Próximamente haré un apartado más completo para la documentación de la API y como utilizarla con diferentes lenguajes (PHP, Javascript, etc).
Para recuperar datos de un producto (es decir, un libro, un juego, etc.) debes llamar hacer GET a la siguiente URL:
http://minerva.hiperreal.net/ws/producto/{id_publico}
Donde el parámetro {id_publico} es el código público de Minerva para identificar el producto. Puedes descubir el id público de cualquier producto en la URL de Minerva.
Si buscamos el Códice hermético lo encontramos en ésta URL: http://minerva.hiperreal.net/producto/ARM009 donde vemos el código público, que en éste caso es ARM009. Por tanto desde nuestra APP tendremos que hacer GET a la URL http://minerva.hiperreal.net/ws/producto/ARM009 para recuperar los datos en JSON del Códice Hermético.
Si quieres una lista de productos filtrados por línea/colección de juego debes hacer una llamada GET a la siguiente URL:
http://minerva.hiperreal.net/ws/productos?juego={id_publico}
Dónde el parámetro {id_publico} es el código público de la colección/línea (p.e. "DND" para Dungeons & Dragons).
Si quieres una lista de productos filtrados por clase de juego debes hacer una llamada GET a la siguiente URL:
http://minerva.hiperreal.net/ws/clase/{id_publico}
Dónde el parámetro {id_publico} es el código público de la clase (*p.e. "rol" para juegos de rol).