Documentación

Livescore_req livescore

Description

Petición de nivel 2: Dada una serie de requisitos, la petición busca partidos que concuerden con los parámetros indicados y devuelve un listado con un número limitado de ellos.

Result of the request

La petición devuelve como resultado un listado con los partidos que cumplen todos los requisitos indicados en los parámetros de entrada. Además, se adjunta también un listado con un resumen de los partidos que se disputan en el día, cuántos en España y cuántos se están disputando en ese momento.

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.

teams: listado de identificadores de equipos. Cada identificador debe ir separado por ‘,’ y debe venir acompañado de los parámetros ‘country’ y ‘date’.

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 en juego. 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. Tiene que venir acompañado del parámetro ‘country’ para ser utilizado. El formato debe ser ‘YYYY-MM-DD’.

play: indica si se quieren sólo los partidos que se encuentran en juego en el momento que se realiza la petición.

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.

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. Por defecto, su valor es 40 y no puede ser nunca superior a dicho número.

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

Examples

En el ejemplo se obtiene el listado de los partidos que se encuentra en juego en este mismo momento.

XML

https://apiclient.besoccerapps.com/scripts/api/api.php?key=YOUR_KEY & tz=Europe/Madrid & format=xml & req=livescore

JSON

https://apiclient.besoccerapps.com/scripts/api/api.php?key=YOUR_KEY & tz=Europe/Madrid & format=json & req=livescore

TEXT

https://apiclient.besoccerapps.com/scripts/api/api.php?key=YOUR_KEY & tz=Europe/Madrid & format=text & req=livescore

Estadisticas de peticiones

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

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


Documentación de salida

^ array:2 [
  "matches" => array:1 [
    0 => array:27 [
      "id" => "Identificador del partido"
      "round" => "Jornada del partido"
      "local" => "Nombre del equipo local"
      "visitor" => "Nombre del equipo visitante"
      "competition_name" => "Nombre de la competición"
      "league_id" => "Identificador de la liga"
      "category_id" => "Identificador de la categoría"
      "total_group" => "Número total de grupos"
      "team1" => "Identificador del equipo local la temporada del partido"
      "team2" => "Identificador del equipo visitante la temporada del partido"
      "numc" => "Número de comentarios"
      "year" => "Temporada activa del partido"
      "playoffs" => "Con valor 1 indica que el partido es de tipo playoffs"
      "group_code" => "Grupo de la catgoría, los playoffs siempre son grupo 0"
      "coef" => "Coeficiente de importancia del partido"
      "cflag" => "Bandera del país"
      "local_shield" => "Escudo del equipo local"
      "visitor_shield" => "Escudo del equpo visitante"
      "date" => "Fecha del partido"
      "hour" => "Hora del partido"
      "minute" => "Minuto del partido"
      "result" => "Resultado del partido"
      "penaltis1" => "Penaltis del equipo local para tandas de penaltis"
      "penaltis2" => "Penaltis del equipo visitante para tandas de penaltis"
      "live_minute" => "Minuto del partido cuando está en directo"
      "status" => "Estado del partido, -1: Sin comenzar, 0: Directo, 1: Finalizado, 2: Aplazado, 3: Prorroga, 4: Penaltis, 5: Descanso"
      "channels" => []
    ]
  ]
  "summary" => array:3 [
    "today" => "Partidos que se disputan hoy"
    "spain" => "Partidos de España"
    "live" => "Partidos en directo"
  ]
]
Copyright 2021 © BeSoccer Api. Todos los derechos reservados - Aviso Legal y Política de privacidad