Documentación

Categories_req categories

Description

Petición de nivel 1: En esta petición, dado un filtro de selección y/o un código de país, se devuelve como resultado un listado de las competiciones que cumplen con los valores indicados en los parámetros de entrada de la función.

Result of the request

El resultado devuelto por la petición será un listado con las competiciones que cumplen con todos los requisitos iniciales y que se encuentran en la base de datos. En caso de que los parámetros de entrada no se correspondan con un valor permitido o no se encuentren datos que cumplan todos los requisitos, la petición devolverá un array vacío.

Request parameters

country: parámetro que indica el código del país al que pertenecen las competiciones que se buscan. 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.

extra: parámetro especial empleado para los widgets.

filter: este parámetro indicará qué criterios se emplearán para realizar la selección de competiciones en la base de datos. El filtro actuará según el valor que se le indique en la entrada, siendo posibles los que se comentan a continuación: ‘all’ (todas las competiciones), ‘top’ (las que ‘top’ vale 1), ‘spain’ (se disputan en España), ‘leagues’ (se juegan fuera de España), ‘competitions’ (competiciones internacionales), o ‘country’ (disputadas donde indica el parámetro con el mismo nombre), 'my_leagues' (muestra las competiciones contratadas, máximo 50)

Examples

Este ejemplo muestra un listado con todas las competiciones

XML

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

JSON

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

TEXT

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

Estadisticas de peticiones

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

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


Documentación de salida

^ array:1 [
  "category" => array:1 [
    0 => array:18 [
      "id" => "Identificador de la categoría"
      "league_id" => "Identificador de la liga"
      "order" => "Indice de ordenación"
      "year" => "Temporada"
      "c_pending" => "Info de RF"
      "name" => "Nombre de la competición"
      "country" => "País"
      "continent" => "Continente"
      "current_round" => "Jornada actual"
      "total_group" => "Total de grupos"
      "total_rounds" => "Total de jornadas"
      "flag" => "Bandera del país"
      "logo" => "Logo"
      "phase" => "Fase de la competición"
      "playoff" => "Con valor 1 es una competición de playoffs"
      "group_code" => "Grupo"
      "legend" => "Info de RF"
      "legend_dict" => "Info de RF"
    ]
  ]
]
Copyright 2021 © BeSoccer Api. Todos los derechos reservados - Aviso Legal y Política de privacidad