Documentación

On TV_req tv_matches

Description

Petición de nivel 1: Esta petición devuelve un listado con los partidos que son televisados por algún canal de televisión y que cumple con todos los requisitos expuestos en los parámetros de entrada.

Result of the request

El resultado que devuelve la petición es un listado de los partidos que se televisan y que cumplen todos los requisitos indicados en los parámetros de entrada. Para cada partido se mandará, además de la información del partido, un listado de los canales que retransmiten el encuentro.

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.

size: indica el tamaño de las imágenes.

teams: listado de identificadores de equipos. Cada identificador debe ir separado por ‘,’.

competitions: listado de identificadores de competiciones. Cada identificador debe ir separado por ‘,’.

country: parámetro que indica el código del país al que pertenecen las competiciones en las que se buscarán partidos televisados. Dicho código de país se rige por el estándar ISO 3166-1 y consiste en 2 caracteres que indican el nombre del país. Existen caso especiales como es el caso de las competiciones europeas para el que se emplea el código ‘ue’ o el resto de competiciones internacionales para el que se emplea ‘wo’. Para más detalle, consultar en http://es.wikipedia.org/wiki/ISO_3166-1.

date: fecha para la que se buscan partidos televisados. El formato debe ser ‘YYYY-MM-DD’. Si no se indica ningún valor, seleccionará los partidos televisados en los próximos 7 días.

play: indica que se seleccionen sólo los partidos que se encuentren en juego.

init: indica el índice a partir del cual se empezará a extraer los datos obtenidos. Su valor por defecto es 0.

limit: indica el número máximo de resultados que se pueden devolver como respuesta de la petición.

top: este parámetro señala que se seleccionen sólo las competiciones cuyo atributo ‘top’ vale 1.

Examples of last similar requests

Params Response Time Size

format=json&req=tv_matches&isocode=es&date=2021-10-01&lang=es

6.5 ms 0.06 kb

format=json&req=tv_matches&isocode=es&date=2021-10-03&lang=es

5.9 ms 0.07 kb

format=json&req=tv_matches&isocode=es&date=2021-10-23&lang=es

37.5 ms 24.25 kb

format=json&req=tv_matches&isocode=es&date=2021-10-16&lang=es

39.2 ms 61.85 kb

format=json&req=tv_matches&isocode=es&date=2021-10-22&lang=es

27.9 ms 6.55 kb

format=json&req=tv_matches&isocode=es&date=2021-10-02&lang=es

53.3 ms 69.37 kb

format=json&req=tv_matches&isocode=es&date=2021-10-24&lang=es

19.8 ms 11.06 kb

format=json&req=tv_matches&isocode=es&date=2021-10-25&lang=es

15.5 ms 1.98 kb

format=json&req=tv_matches&isocode=es&date=2021-10-17&lang=es

34.7 ms 13.98 kb

Examples

En el ejemplo se devuelve un listado con los partidos disputados y televisados por algún canal el 18 de Febrero de 2016.

XML

https://apiclient.besoccerapps.com/scripts/api/api.php?key=YOUR_KEY & tz=Europe/Madrid & format=xml & req=tv_matches & media= & date=2016-02-18

JSON

https://apiclient.besoccerapps.com/scripts/api/api.php?key=YOUR_KEY & tz=Europe/Madrid & format=json & req=tv_matches & media= & date=2016-02-18

TEXT

https://apiclient.besoccerapps.com/scripts/api/api.php?key=YOUR_KEY & tz=Europe/Madrid & format=text & req=tv_matches & media= & date=2016-02-18

Estadisticas de peticiones

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

Tamaño promedio de respuesta
Peticiones: 43.82 kb
General: 4.56 kb


Documentación de salida

^ array:2 [
  "match" => array:1 [
    0 => array:27 [
      "id" => "Identificador del partido"
      "round" => "Jornada"
      "local" => "Equipo local"
      "visitor" => "Equipo visitante"
      "competition_name" => "Primera División"
      "cflag" => "Bandera del país"
      "league_id" => "Identificador de liga"
      "category_id" => "Identificador de categoría"
      "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"
      "year" => "Temporada"
      "playoffs" => "Con valor 1 es una competición de playoffs"
      "group_code" => "Grupo"
      "coef" => "Coeficiente de importancia del partido"
      "numc" => "Número de comentarios en RF"
      "prorroga" => "Con valor 1 indica que estamos en la prórroga"
      "local_shield" => "Escudo equipo local"
      "visitor_shield" => "Escudo equipo visitante"
      "date" => "Día del partido"
      "hour" => "Hora del partido"
      "minute" => "Minuto del partidos"
      "result" => "Resultado del partido"
      "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:3 [
          "id" => "Identificador del canal de televisión"
          "name" => "Nombre del canal de televisión"
          "image" => "Logo del canal"
        ]
      ]
    ]
  ]
  "summary" => array:3 [
    "today" => "Total de partidos televisados"
    "spain" => "Total de partidos España televisados"
    "live" => "Total de partidos en directo"
  ]
]
Copyright 2021 © BeSoccer Api. Todos los derechos reservados - Aviso Legal y Política de privacidad