API BDFutbol v1.0 23/08/2016. Los datos se ofrecen en diferentes formatos: HTML, XML y JSON.

Transcripción

1 API BDFutbol v1.0 23/08/2016 Introducción La API de BDFutbol ofrece datos de la temporada actual y de todo el histórico de las ligas españolas (primera, segunda y segunda B), y las principales ligas europeas (inglaterra, Italia, alemania, francia). Los datos se ofrecen en diferentes formatos: HTML, XML y JSON. General La API de BDFutbol se encuentra en la dirección La entificación de usuario se realiza con los parámetros 'u' (usuario) y 'ps' (contraseña). Ejemplo: Los datos se pueden obtener en formato HTML, XML o JSON a través del parámetro 'format'. Cuenta con 7 tipos de petición disponibles. Petición Clasificación Resultados Plantilla Jugador Entrenador Equipo Parto Parámetro tip=cla tip=res tip=pla tip=jug tip=ent tip=eq tip=p Clasificación Para obtener los datos de una clasificación, los parámetros adicionales son: Categoría cat '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra' Temporada temp Ej: , , etc El resultado contiene un listado de equipos, cada uno con los siguientes datos: posicion Posición en la clasificación final

2 _equipo _equipo puntos pj pg pe pp gf gc Código del equipo Nombre del equipo (en esa temporada) Puntos del equipos al final de la temporada Partos jugados Partos ganados Partos empatados Partos perdos Goles a favor Goles en contra En caso de que la temporada peda no esté disponible la respuesta será un texto con el valor Not Found. Resultados Para obtener el listado de todos los partos de una temporada, los parámetros adicionales son (igual que en clasificación). Categoría cat '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra' Temporada temp Ej: , , etc El resultado contiene un listado de resultados, cada uno con los siguientes datos: _equipo fecha jornada _local _local _visitante _visitante goles_local goles_visitante _arbitro _arbitro estadio Código del parto Fecha del parto, en formato dd/mm/yyyy Jornada de liga Código del equipo local Nombre del equipo local Código del equipo visitante Nombre del equipo visitante Goles del equipo local Goles del equipo visitante Código del árbitro Nombre del árbitro Nombre del estadio En caso de que la temporada peda no esté disponible la respuesta será un texto con el valor Not Found.

3 Plantilla Para obtener los datos de la plantilla de un equipo en una temporada concreta, los parámetros son: Equipo equipo Numérico (código del equipo) Temporada Temp Ej: , , etc El resultado es un listado de jugadores, con los siguientes datos: apodo pj g min ta tr Código del jugador Apodo del jugador Partos jugados Goles marcados Minutos jugados Tarjetas amarillas Tarjetas rojas En caso de que la plantilla peda no esté disponible la respuesta será un texto con el valor Not Found. Jugador Los datos de un jugador se pueden obtener a través de los parámetros: Código jugador Numérico apodo fecha_nac lugar_nac pais posicion altura peso trayectoria Apodo del jugador Nombre y apellos del jugador Fecha de nacimiento (formato dd/mm/yyyy) Lugar de nacimiento País de nacimiento (formato ISO alpha-2) Posición en el campo (valores posibles: Portero, Defensa, Central, Lateral Derecho, Lateral Izquierdo, Centrocampista, Delantero, Delantero Centro Altura del jugador en centímetros Peso del jugador en kilogramos Listado de ítems

4 El campo trayectoria contiene un listado de los equipos donde ha estado el jugador, con los siguientes campos: equipo equipo temporada categoria pj pt pc ps min ta tr g Código del equipo Nombre del equipo Temporada en formato (yyyy-yy) Categoría en la que participaba. Valores posibles: 1, 2, 2B Partos jugados Partos titular Partos completo Partos suplente Minutos Tarjetas amarillas Tarjetas rojas Goles marcados Entrenador Los datos de un entrenador se pueden obtener a través de los parámetros: Código entrenador Numérico apodo fecha_nac pais trayectoria Apodo del jugador Nombre y apellos del jugador Fecha de nacimiento (formato dd/mm/yyyy) País de nacimiento (formato ISO alpha-2) Listado de ítems El campo trayectoria contiene un listado de los equipos donde ha estado el jugador, con los siguientes campos: equipo equipo temporada categoria Código del equipo Nombre del equipo Temporada en formato (yyyy-yy) Categoría en la que participaba. Valores posibles: 1, 2, 2B

5 pj Partos dirigos Equipo Los datos de un equipo se pueden obtener a través de los parámetros: Código equipo Numérico fundacion ciudad estadio aforo Nombre del equipo Fecha de fundación (formato texto, puede ser solo el año, o en formato dd/mm/yyyy) Ciudad del equipo Estadio actual del equipo Aforo actual del estadio Parto Los datos de un parto se pueden obtener a través de los parámetros: Código parto Numérico temporada categoria jornada equipolocal equipovisitante equipolocal nomreequipovisitante goleslocal golesvisitante Código del parto Temporada del parto en formato yyyy-yy Categoría del parto. Valores posibles: 1a", 2a", 2aB1, 2aB2, 2aB3, 2aB4, eng, ger, ita, fra, cha, uef, cop Jornada del parto (en caso de que sea parto de liga) Código equipo local Código equipo visitante Nombre equipo local Nombre equipo visitante Goles local Goles visitante

6 estadio fecha arbitro alineacionlocal alineacionvisitante Estadio Fecha en formato dd/mm/yyyy Nombre del árbitro Alineación visitante Alineacion visitante Las alineaciones son objetos con los siguientes campos: entrenador jugadores Datos del entrenador Listado de jugador Los entrenadores tienen los siguientes datos: Código del entrenador Apodo del entrenador Los jugadores tienen los siguientes datos: tipo eventos cambio Código del jugador Valores posibles: - T: Titular - S: Suplente Listado de evento Este campo es opcional. Si el jugador ha so substituo en este campo aparecerán los subcampos y minuto, que entifican al jugador que le ha substituo y el minuto en que el cambio se produjo. Los eventos tienen los siguientes campos: tipo minuto Valores posibles: - TA: Tarjeta amarilla - TR: Tarjeta roja - G: Gol - GPEN: Gol penalti - GPP: Gol propia meta Minuto del evento