Documentación

Matches_req matchs

Description

Petición de nivel 1: Dado el identificador de una competición, esta petición devuelve un listado con los partidos de dicha competición que cumplen cada uno de los requisitos indicados en los parámetros de entrada.

Result of the request

El resultado devuelto será un listado de partidos que cumplen con todos los requisitos planteados en la entrada de parámetros. Por cada partido se detalla su información básica: identificador, equipos, horario, resultado, canales de televisión que lo retransmiten, etc.

Request parameters

tz: indica el timezone del lugar donde se encuentra el dispositivo desde el que realiza la llamada a la petición. Por defecto, su valor es Europe/Madrid.

order: Indica el orden en el que se devuelven los partidos. El único valor posible es ‘twin, haciendo que los partidos de eliminatorias sean devueltos por parejas (los partidos de la misma eliminatoria se devuelven uno seguido del otro).

site: la aplicación desde la que se realizó la petición.

v: la versión de la aplicación que realizó la petición.

twolegged: indica que se devuelvan los partidos de la misma eliminatoria agrupados por emparejamiento e incluyendo un campo adicional con el resultado global de la eliminatoria.

round: número de la jornada a la que pertenecen los partidos. Si no se indica valor, el parámetro valdrá, por defecto, el número de la jornada activa de la temporada indicada.

league: identificador de la categoría en la que se buscan los partidos.

group: este parámetro muestra el filtro de grupo que se tendrá en consideración. Sus posibles valores son: ‘all’ (todos los grupos cuyo número es mayor de 0), ‘playoff’ (selecciona los grupos cuyo valor es 0) o el número del grupo dentro de la competición.

year: temporada en la que se buscan las competiciones. Si no tiene valor, éste será, por defecto, la temporada actual.

Examples of last similar requests

Params Response Time Size

group=8&year=2022&tz=Europe/Madrid&format=json&extra=more_info&req=matchs&league=2470&v=9

97.4 ms 10.14 kb

group=2&year=2022&tz=Europe/Madrid&format=json&extra=more_info&req=matchs&league=2468&v=9

118.8 ms 14.06 kb

group=1&year=2019&tz=Europe/Madrid&lang=es&clang=es&isocode=es&format=json&req=matchs&league=25&round=19&order=twin&twolegged=1

103.2 ms 14.12 kb

group=1&year=2021&tz=Europe/Madrid&lang=es&clang=es&isocode=es&format=json&req=matchs&league=9&round=22&order=twin&twolegged=1

86.8 ms 10.46 kb

tz=Europe/Madrid&format=json&req=matchs&order=asc&league=1

81.9 ms 12.87 kb

group=all&year=2022&tz=Europe/Madrid&format=json&req=matchs&extra=more_info&league=2468&round=10

266 ms 27.31 kb

group=all&year=2022&tz=Europe/Madrid&format=json&extra=more_info&req=matchs&league=2468&round=8&v=9

176.7 ms 27.68 kb

group=1&year=2022&tz=Europe/Madrid&format=json&req=matchs&extra=more_info&league=2468&round=8

97.8 ms 13.59 kb

group=3&year=2022&tz=Europe/Madrid&format=json&req=matchs&extra=more_info&league=2469&round=7

146.9 ms 12.72 kb

group=all&year=2022&tz=Europe/Madrid&format=json&extra=more_info&req=matchs&league=2368&round=12&v=9

207.2 ms 10.95 kb

group=all&year=2022&tz=Europe/Madrid&format=json&req=matchs&extra=more_info&league=1&round=11

112.4 ms 13.29 kb

group=all&year=2022&tz=Europe/Madrid&format=json&extra=more_info&req=matchs&league=2468&round=7&v=9

218.7 ms 27.55 kb

group=1&year=2022&tz=Europe/Madrid&format=json&extra=more_info&req=matchs&league=282&v=9

174.9 ms 11.42 kb

group=1&year=2019&tz=Europe/Madrid&lang=es&clang=es&isocode=es&format=json&req=matchs&league=25&round=20&order=twin&twolegged=1

97.5 ms 14.08 kb

group=1&year=2022&tz=Europe/Madrid&lang=es&clang=es&isocode=es&format=json&req=matchs&league=2&round=33&order=twin&twolegged=1

94.2 ms 12.69 kb

tz=Europe/Madrid&format=json&req=matchs&league=2&round=5

116.4 ms 15.29 kb

group=1&year=2022&tz=Europe/Madrid&format=json&extra=more_info&req=matchs&league=2468&v=9

98.8 ms 13.59 kb

group=1&year=2019&tz=Europe/Madrid&lang=es&clang=es&isocode=es&format=json&req=matchs&league=37&round=21&order=twin&twolegged=1

87.4 ms 10.7 kb

group=2&year=2022&tz=Europe/Madrid&format=json&req=matchs&extra=more_info&league=2468&round=7

101.2 ms 13.63 kb

group=1&year=2022&tz=Europe/Madrid&format=json&extra=more_info&req=matchs&league=1&v=9

97.1 ms 14.1 kb

Examples

El resultado obtenido al realizar la petición es la información de los partidos disputados la jornada 7 de primera división temporada 2013/14.

XML

https://apiclient.besoccerapps.com/scripts/api/api.php?key=YOUR_KEY & tz=Europe/Madrid & format=xml & req=matchs & league=1 & round=7 & order=twin & twolegged=1 & year=2020

JSON

https://apiclient.besoccerapps.com/scripts/api/api.php?key=YOUR_KEY & tz=Europe/Madrid & format=json & req=matchs & league=1 & round=7 & order=twin & twolegged=1 & year=2020

TEXT

https://apiclient.besoccerapps.com/scripts/api/api.php?key=YOUR_KEY & tz=Europe/Madrid & format=text & req=matchs & league=1 & round=7 & order=twin & twolegged=1 & year=2020

Estadisticas de peticiones

Tiempo promedio de respuesta
Peticiones: 126.6 ms
General: 0,062 s

Tamaño promedio de respuesta
Peticiones: 14.45 kb
General: 4.57 kb


Documentación de salida

^ array:3 [
  "match" => array:1 [
    0 => array:37 [
      "id" => "Identificador del partido"
      "year" => "Temporada"
      "group" => "Grupo"
      "total_group" => "Total grupos"
      "round" => "Jornada"
      "local" => "Equipo local"
      "visitor" => "Equipo visitante"
      "league_id" => "Identificador de liga"
      "team1" => "Identificador del equipo local para la temporada del partido"
      "team2" => "Identificador del equipo visitante para la temporada del partido"
      "dteam1" => "Identificador único del equipo local"
      "dteam2" => "Identificador único del equipo visitante"
      "numc" => "Número de comentarios en RF"
      "no_hour" => "Info para RF"
      "local_abbr" => "Nombre corto del equipo local"
      "visitor_abbr" => "Nombre corto del equipo visitante"
      "competition_name" => "Nombre de la competición"
      "playoffs" => "Con valor 1 es una competición de playoffs"
      "group_code" => "Grupo"
      "coef" => "Coeficiente de importancia del partido"
      "local_shield" => "Escudo equipo local"
      "visitor_shield" => "Escudo equipo visitante"
      "extraTxt" => "Información extra"
      "schedule" => "Fecha y hora del partido"
      "date" => "Día del partido"
      "hour" => "Hora del partido"
      "minute" => "Minuto del partidos"
      "local_goals" => "Goles equipo local"
      "visitor_goals" => "Goles equipo visitante"
      "result" => "Resultado"
      "live_minute" => "Minuto del partido cuando está en directo"
      "status" => "-1: Sin comenzar, 0: Directo, 1: Finalizado, 2: Aplazado, 3: Prorroga, 4: Penaltis, 5: Descanso"
      "channels" => array:1 [
        0 => array:2 [
          "name" => "Nombre del canal de televisión"
          "image" => "Logo del canal"
        ]
      ]
      "winner" => "Info para RF"
      "penaltis1" => "Penaltis marcados por equipo local en tanda de penaltis"
      "penaltis2" => "Penaltis marcados por equipo visitante en tanda de penaltis"
      "prorroga" => "Info para RF"
    ]
  ]
  "twolegged" => "Info para RF"
  "linked_matches" => "Info para RF"
]
Copyright 2021 © BeSoccer Api. Todos los derechos reservados - Aviso Legal y Política de privacidad