[API] Transformice - Cómo usarla

API - Transformice

La interfaz de programación de aplicaciones (API), no es más que un conjunto de servicios y/o funciones que un sistema (Transformice) ofrece cierta biblioteca al programador (ClubMice). Todo ésto es usualmente utilizado en programación.

He decidido compartir mi API que es proveída por el servidor de Transformice para darnos la posibilidad de realizar ciertas herramientas. En éste caso, una herramienta de estadísticas en forma de un perfil dinámico que en otro hilo la compartiré con ustedes.

¿Qué es y para qué sirve JSON?

Mientras tanto, compartiré lo que he hecho; creación de un JSON a partir de una consulta en MySQL, para que ustedes puedan, a partir de ésta creación, gestionar JSON en PHP, y poder crear sus propias herramientas en base a la obtención de valores a través de éste sistema.

Uso

Usar la función json_decode para decodificar un JSON.

Supongamos que éste es nuestro JSON generado, a partir del enlace: https://club-mice.com/yuir_lacasitos/api.php?user=usuario

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

{"name":"Streaxx#0001",
"id":"23671350",
"badges":"129,133,5,135,8,137,138,10,12,140,141,14,143,146,20,149,23,24,152,153,27,28,157,29,30,34,35,37,40,170,42,171,43,173,174,175,176,48,177,179,180,52,54,55,183,185,187,60,61,189,62,191,63,64,192,65,193,194,195,67,196,197,71,199,200,201,203,204,205,206,207,208,",
"look":"109;0,0,48,40,35,48,31,17,0,0,0",
"title_id":"454",
"title":"\u00abFit Mouse\u00bb",
"experience":"54450",
"first":"48",
"bootcamp":"0",
"round_played":"56457",
"shaman_cheese":"16",
"saved_mice":"633",
"saved_mice_hard":"0",
"saved_mice_divine":"0",
"cheese_gathered":"2438",
"dress_list":"113;0,25_9e2323,0,16,31,23,27_b50e31+b50e31,14,0;78583a;95d9d6\/46;128,0,0,60,0,22_503d0f,10,0,0;78583a;95d9d6\/108;166,4,42_9c633b+fdf8eb,2,0,0,0,0,0;78583a;95d9d6\/1;44_e9c9f0+f2b9fe+ddd6e6,0,25_77afee+f5ebdf+fddf5d,0,30_ffffff+77afee+af7e58,17_eae0c2+e2c7c",
"color1":"78583a",
"color2":"95d9d6",
"skills":"0,5;2,4;4,1;5,5;6,5;7,1;9,5;11,4;12,5;20,5;22,5;23,5;26,5;29,4;30,1;32,5;33,1;34,1;40,5;42,5;45,5;46,3;48,5;49,5;51,5;54,1",
"survivor_round_played":"2702",
"survivor_mouse_killed":"1595",
"survivor_shaman_count":"208",
"survivor_survivor_count":"866",
"racing_round_played":"106",
"racing_finished_map":"17",
"racing_first":"0",
"racing_podium":"2",
"registration_date":"20\/10\/2012",
"avatar":"http:\/\/avatars.atelier801.com\/1350\/23671350.jpg",
"level":43}

Vamos a usar la función json_decode sobre este JSON, para ello vamos a suponer que nuestro JSON es un JSONArray, es decir que es un array de datos, así pues, vamos a guardar en un array el resultado de decodificar el JSON.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

$json = '{"name":"Streaxx#0001",
"id":"23671350",
"badges":"129,133,5,135,8,137,138,10,12,140,141,14,143,146,20,149,23,24,152,153,27,28,157,29,30,34,35,37,40,170,42,171,43,173,174,175,176,48,177,179,180,52,54,55,183,185,187,60,61,189,62,191,63,64,192,65,193,194,195,67,196,197,71,199,200,201,203,204,205,206,207,208,",
"look":"109;0,0,48,40,35,48,31,17,0,0,0",
"title_id":"454",
"title":"\u00abFit Mouse\u00bb",
"experience":"54450",
"first":"48",
"bootcamp":"0",
"round_played":"56457",
"shaman_cheese":"16",
"saved_mice":"633",
"saved_mice_hard":"0",
"saved_mice_divine":"0",
"cheese_gathered":"2438",
"dress_list":"113;0,25_9e2323,0,16,31,23,27_b50e31+b50e31,14,0;78583a;95d9d6\/46;128,0,0,60,0,22_503d0f,10,0,0;78583a;95d9d6\/108;166,4,42_9c633b+fdf8eb,2,0,0,0,0,0;78583a;95d9d6\/1;44_e9c9f0+f2b9fe+ddd6e6,0,25_77afee+f5ebdf+fddf5d,0,30_ffffff+77afee+af7e58,17_eae0c2+e2c7c",
"color1":"78583a",
"color2":"95d9d6",
"skills":"0,5;2,4;4,1;5,5;6,5;7,1;9,5;11,4;12,5;20,5;22,5;23,5;26,5;29,4;30,1;32,5;33,1;34,1;40,5;42,5;45,5;46,3;48,5;49,5;51,5;54,1",
"survivor_round_played":"2702",
"survivor_mouse_killed":"1595",
"survivor_shaman_count":"208",
"survivor_survivor_count":"866",
"racing_round_played":"106",
"racing_finished_map":"17",
"racing_first":"0",
"racing_podium":"2",
"registration_date":"20\/10\/2012",
"avatar":"http:\/\/avatars.atelier801.com\/1350\/23671350.jpg",
"level":43}';
$array = json_decode($json);

Para finalizar, puedes usar la función print_r($array); para mostrar todos éstos datos obtenidos de la manera que más gustes. Al igual, todos estos datos son genéricos, pueden cambiar depende a lo que vayas a hacer con esta API.

Información adicional

En caso de que no hayas entendido o necesites que amplíe la información otorgada aquí, puedes pedírmelo. Siempre y cuando no me pidas que te haga el código completo.

Por ahora, puedo proporcionarte parte del código que he usado en mi sistema de estadísticas para que lo uses o puedas entender mejor todo.

1
2
3
4
5
6

<?php

$mice = file_get_contents('https://club-mice.com/yuir_lacasitos/api.php?user='.$usuario.''); 
$stats = json_decode($mice);

?>

Última actualización: 2018-04-06 09:57:21

Dernière modification le

me explicas? :0

[Modéré par Ratacp, raison : Fuera de tema]

Khe es?

Debí percatar ésto antes, pero lamentándolo mucho la API no funcionará hasta que consiga a alguien responsable con una página segura que me permita aparcar allí la herramienta, puesto que mi anterior página ha caducado y no está en mis posibilidades ni en la de ningún otro administrador de la misma poder pagarla.

Que mal que imices cerro . . . :(

[Modéré par Flumazenil, raison : Fuera de tema.]

[Modéré par Flumazenil, raison : No aporta al tema / cita al comentario número 7.]

Holi, de casualidad me podrias compartir los endpoints de la api de TFM? o me podrias brindar una luz de como es el procedimiento para solicitarlo?

#10

[05/03/17]
La API vuelve a funcionar. (y la página)

#11

Próximamente se actualizará la API y se mostrarán más datos de los usuarios, incluyéndose: título, nivel y prestigio del foro. Además de arreglar ciertos errores y añadir ciertas novedades.

#12

Yuir a dit :
Próximamente se actualizará la API y se mostrarán más datos de los usuarios, incluyéndose: título, nivel y prestigio del foro. Además de arreglar ciertos errores y añadir ciertas novedades.

-esperando-<3

#13

[•] Por problemas de seguridad la API no se encuentra funcionando, trataremos de solucionarlo lo antes posible.

#14

La API ya funciona, y tenemos un nuevo enlace para que puedan acceder a ella. Toda la información requerida contenida al principio del hilo.

#15

Yuir a dit :
La API ya funciona, y tenemos un nuevo enlace para que puedan acceder a ella. Toda la información requerida contenida al principio del hilo.

Genial :D

#16

[ACTUALIZACIÓN]
Pueden mostrar las estadísticas de las tribus con esta API:
https://api.club-mice.com/tribe.php?name=nombredetribu
ó
http://api.club-mice.com/tribeid.php?name=idtribu
(recomiendo usar la segunda opción, ya que algunas tribus tienen caracteres especiales en el nombre y resulta difícil encontrarla en la API)

Por ejemplo, en caso de mi tribu sería:
https://api.club-mice.com/tribe.php?name=Ayax%20Incorporated
o bien, por el ID:
http://api.club-mice.com/tribeid.php?name=846988
(para saber el ID de tu tribu, ve a tu perfil del foro y haz clic en el nombre de tu tribu > Perfil, el ID saldrá en la dirección url):
http://atelier801.com/tribe?tr=846988

Los datos que mostrará son los siguientes:

1
2
3

{"name":"Ayax Incorporated",
"id":"846988",
"avatar":"http:\/\/logostribu.atelier801.com\/6988\/846988.jpg"}

Con esto, pueden llegar a mostrar las estadísticas de todas las tribus, por ejemplo:
Un buscador (clic aquí)
Estadísticas de una tribu (clic aquí)

Et voilà !

#17

Gracias esta buenisimo!

#18

[•] Actualicé el hilo ya que hubieron ciertos cambios en la página que impedían el correcto funcionamiento de la API con la información que aquí se mostraba.

[•] Errores solucionados.

[•] Mejoras implementadas.

English	Français
Português do Brasil	Español
Türkçe	Polski
Magyar	Română
العربية	Skandinavisk
Nederlands	Deutsch
Bahasa Indonesia	Русский
中文	Filipino
Lietuvių kalba	日本語
Suomi	עברית
Italiano	Česky
Hrvatski	Slovensky
Български	Latviešu
Estonian

Langue