API de Podium Sports
Bienvenido a la API de Podium Sports. Este documento sirve como introducción a nuestra API, y como complemento a nuestro Documentación sobre semáforos que proporciona información técnica para desarrolladores sobre cómo integrarse. La API de carreras ofrece todos los datos de tarjetas, apuestas y resultados de Podio a través de una API RESTful. Para los datos en los que el tiempo es esencial, también ofrecemos la posibilidad de recibir entregas PUSH de puntos de datos específicos del día de la carrera.
Productos y servicios:
Los siguientes servicios están disponibles en la API de Podio.
Tarjetas de carreras:Pondremos a su disposición en la API toda la información relativa a futuros eventos tan pronto como la recibamos de la autoridad competente. Esto puede ocurrir con semanas de antelación y, en el caso de algunas carreras, con meses. Normalmente, esperamos que los datos de las tarjetas de las carreras del Reino Unido e Irlanda estén disponibles a partir de los seis días anteriores a las declaraciones de 48 horas. En el apéndice se incluye un desglose completo de los datos de la API.
La API ofrecerá una cobertura mundial de las carreras en el Reino Unido, Estados Unidos, Francia y Sudáfrica, entre otros países. En el Apéndice A figura la lista completa de países y circuitos cubiertos por la API.
Tarjeta: La API ofrecerá un resumen completo de las próximas reuniones, con lugares, horarios de las carreras, salidas, caballos, jockeys e información complementaria sobre entrenadores, propietarios y criadores.
Avances editoriales: La API ofrece comentarios curados sobre ambas carreras y los caballos que participan en ellas (veredictos y pinstickers), así como consejos.
Precio previsto: Podium anunciará el precio previsto antes de que los espectáculos estén disponibles, hasta dos días antes del comienzo de la carrera.
Formulario : Ofrecemos información sobre el estado de forma de caballos, jockeys y entrenadores, incluida información sobre su carrera. También ofrecemos una relación detallada, a través de un punto final específico, de las seis últimas carreras en las que ha participado un caballo.
Sedas : Podium proporcionará acceso a nuestro generador Bombyx Silks a través de la API mediante una descarga asociada directamente al corredor. Esto ofrece imágenes SVG de alta calidad de las sedas de jockey utilizadas en una carrera. Tenga en cuenta que necesitará estar en la lista blanca para utilizar este servicio, por lo que necesitaremos la dirección IP desde la que accederá a las sedas si no está en el Reino Unido.
Datos del día de la carrera
Estado de la raza: Podium te notificará el estado actual de la carrera, desde "bajando", "yendo por detrás", etc., pasando por "fuera", hasta "pesado". También te notificaremos cualquier impugnación o modificación del resultado después de la carrera.
Apuestas: El día de la carrera, Podium publicará actualizaciones de precios en directo para todos los caballos participantes en una carrera, desde el espectáculo de apertura hasta el SP. Actualizaremos los precios en el período previo a la salida y, una vez que la carrera haya comenzado, confirmaremos inmediatamente el SP del caballo.
Resultados: Una vez finalizada la carrera, podrás acceder a los resultados. Una vez más, en función de los permisos y el territorio, esto también incluirá comentarios en primer plano una vez que estén disponibles.Cambios de caballos y jinetes : Cualquier cambio en los corredores y jinetes se publicará tan pronto como esté disponible.
a medida que esté disponible.
Comentario: Los comentarios posteriores a la carrera (de cerca) estarán disponibles una vez poblada
Estructura de la API
Nuestra API tiene un Stoplight completamente documentado que contiene información detallada sobre el
estructura de los puntos finales, el formato de los datos y los filtros utilizados en cualquier
para restringir los datos. Está disponible aquí.
- Nuestra API está diseñada como una estructura jerárquica, con nuestro punto final de etapas de lista en la parte superior
de la jerarquía
Puedo recuperar una lista de eventos (carreras) y los datos asociados (es decir, ir, premios,
estado) del punto final de las etapas (reuniones) - Puedo recuperar una lista de participantes (caballos) y datos asociados (es decir, apuestas, resultados,
formulario, etc.) desde el punto final de eventos (carreras) - Puedo recuperar una lista de participantes (entrenadores, jockeys y más caballos
información) del punto final entrantes (caballos)
Sin embargo, una vez que se tiene un identificador de etapa, también se puede recuperar todo lo que esté bajo etapas desde
el punto final de detalles de la etapa. Se trata de respuestas extremadamente prolijas (más de 20.000 líneas para una respuesta de
reunión), por lo que es necesario analizarlos para encontrar los datos que se necesitan. Los tiempos de respuesta pueden
debido al volumen de datos.
(Esta estructura también se aplica a los eventos, inscritos y participantes)
- Etapas : El punto final de las etapas proporciona un resumen de alto nivel de todas las reuniones de la carrera
que ocurre dentro de una ventana de datos específica. Esto debe configurarse mediante la función
campos "de" y "a" en la solicitud de API. También ofrecemos la posibilidad de devolver un
país concreto utilizando el filtro "countrycodes" (todos los códigos disponibles en la
países), y la posibilidad de buscar cursos concretos con la función
término "consulta".
o Su respuesta devolverá un identificador de escenario, información sobre el lugar de celebración y una lista de
pruebas (carreras) en cada etapa (reunión).
o También incluimos algunos metadatos resumidos para cada evento.
Eventos: El endpoint Eventos está diseñado para devolver información específica sobre todos los
carreras en el intervalo de fechas facilitado. Estos datos no incluirán información sobre las etapas
(es decir, el lugar de celebración), sino que incluirá el nombre de la carrera, el estado de la misma, el
premios en metálico disponibles para la carrera y la hora de comienzo de la misma. También llevamos
información sobre la clase de carrera, el recorrido, si es con saltos o llana,
distancia y tipo de superficie.
o Contiene una lista de inscritos, su número de puesto y de paño, y su situación
como participante activo en la carrera o como no participante.
o Contiene la seda para cada caballo.
o Una vez completado, el evento también se mejorará con marcas de tiempo para
cambios de estado durante la carrera (por ejemplo, la hora de salida, la hora de llegada)
Para obtener los siguientes conjuntos de datos debe interrogar al punto final DETALLES
- Dividendos de carrera (LCR, tricasts, tote, exacta, trifecta)
- Consejos
- Premios en metálico
- Contenido adicional (comentarios de la carrera, comentarios de Timeform, estadísticas de Timeform Smart)
También ofrecemos una vista de las renovaciones de carreras, de forma que el usuario pueda devolver los ganadores anteriores
- Por ejemplo, los Qipco Sprint Stakes en Ascot en 2024 tienen un uuid de evento de
291d3994-f3ca-4774-8fc2-17802505c083 .
o Puede consultarse en {{$baseURL}}/events/291d3994-f3ca-4774-8fc2-.
17802505c083/winners que devuelve a Art Power como ganador en 2023.
- Entrantes: Entrants requiere que se devuelva un uuid de evento dado, y luego se
devuelve todos los caballos que participan en ese evento. Así, por ejemplo UUID
73751e7f-4edf-4226-b1bf-62c16b0a6e0d (Fairyhouse, IRE, 1 de diciembre de 2024) sería
devolverá una lista de los caballos de esa prueba, información de apoyo y un nivel alto
información del participante sobre el jockey, el entrenador y el propietario. También obtendrá
o Clasificaciones (oficiales y Timeform)
o Todas las probabilidades generadas para el participante a lo largo de la carrera
o Metadatos variados sobre el participante, incluida la distancia recorrida, la forma
cadena, peso, días desde la última carrera
o Posición final o estatus si no ha terminado (es decir, caído, descalificado, desbancado).
jinete, etc.)
o Datos de participantes de alto nivel, como jinete, entrenador, propietario, criador
o Datos del participante sobre el caballo, como edad, historial profesional, sexo, color
y premios en metálico.
o Linaje
- Formulario de inscripción: para ver (hasta) las seis últimas carreras en las que ha competido un caballo puede
utilice el punto final de participantes con el calificador /form para obtener resultados anteriores.
o Así, para el uuid de participante f5158412-7356-42a1-ac5d-763b787657a2 (End Zone) es
Las carreras anteriores pueden obtenerse enviando {{$baseURL}}/entrants/f5158412-
7356-42a1-ac5d-763b787657a2/form
- Participantes : Participantes abarca todas las entidades relacionadas con los caballos. Así que en este caso
Los participantes también incluirán información sobre el jinete, el propietario y el entrenador, como
así como el propio caballo. Estos datos deben duplicarse en la ficha del participante.
punto final.
Revisiones
Hemos introducido el concepto de puntos finales "históricos" en nuestra compilación para que pueda
examinar el historial de actualizaciones de una sede, escenario, evento, participante o inscrito. Cada
actualización que hacemos a una entidad en nuestra DB se almacena y está disponible para volver.
- El formato de cualquier consulta es {{base URL}}/ ENDPOINT / uuid / history
- Así, para una etapa determinada, el formato es /etapas/uuid/historia
o Esto proporcionará un historial completo de cada actualización de datos para una reunión. Nota
puede ser una respuesta considerable. Leicester el 1 de diciembre de 2024 es
165k líneas de JSON, y 400KB.
- Para un evento determinado, events/uuid/history
o esto es útil para ver los cambios de estado, o apostar actualizaciones, o la
actualización específica off
- Para un participante determinado, entrants/uuid/history (tenga en cuenta que esto es distinto del formulario)
o es útil para comprobar las probabilidades específicas de cada participante
- Para un participante participants/uuid/history (esto debería actualizarse después de cada carrera)
o podría utilizarse para generar un historial carrera a carrera del caballo
o jinete
Puntos finales menores
También llevamos algunos puntos finales menores que exponen conjuntos de datos utilizados en otras respuestas. Hacemos
no prevea que necesitará llamar a estos con regularidad.
- País : Una lista de todos los países, sus zonas horarias y sus respectivas monedas.
Tenga en cuenta que el hecho de que un país aparezca en esta lista no significa que llevemos
información sobre carreras. El principal caso de uso sería obtener el código
necesario para el filtrado de países en el punto final de las etapas.
- Divisa : Información sobre todas las divisas presentes en la API
- Superficie: Este endpoint proporciona una lista de todos los tipos de superficie presentes en la API
- Deporte : En la actualidad sólo cubre las carreras de caballos.
Tenga en cuenta que la respuesta en todos los puntos finales se puede filtrar para devolver sólo los puntos de datos
que le interesan. Esto se explica con mucho más detalle en el Apéndice D - filtros de campos
Conexión a la API
Disponemos de una colección POSTMAN para simplificar la realización de llamadas a la API. Si esto tiene
no se ha proporcionado, se puede solicitar. También podemos poner a su disposición un archivo de entorno
con sus credenciales rellenadas.
El acceso a la API se concede a través de la solicitud "get token", que permite el acceso durante 30 días.
minutos. La API funciona con autenticación básica (en Postman - seleccione una llamada, seleccione
autorización, seleccione autenticación básica) - tendrá que introducir el nombre de usuario / contraseña
que le ha proporcionado Podium. Tenga en cuenta que puede establecerlas como
por defecto utilizando la pestaña de entorno para rellenar previamente (y enmascarar) las credenciales de acceso
Tenga en cuenta que la API tiene un límite de retorno de 6 MB. Si lo sobrepasa, se le notificará un
error interno del servidor. Utilice el filtro pagesize para limitar el retorno de página a 1 y ver si eso
resuelve el problema.
Almacenamiento en caché
Para optimizar el rendimiento de la API y reducir la carga de nuestra infraestructura, empleamos
mecanismos de almacenamiento en caché. A través de Amazon ElastiCache, almacenamos las peticiones más frecuentes
en memoria, lo que permite una recuperación más rápida y reduce la necesidad de recuperar los mismos datos.
repetidamente. Esta estrategia de almacenamiento en caché mejora la capacidad general de respuesta y la escalabilidad.
de nuestra API.
Esperamos que las respuestas en caché tarden entre 40 y 60 ms en volver.
Las respuestas no almacenadas en caché pueden tardar hasta varios segundos en función del tamaño del archivo
respuesta.
Nuestra API admite respuestas de hasta 6 MB.
Asistencia técnica y documentación
Como ya se ha dicho, tenemos un Semáforo para guiarle a través de la API.
En caso de que la API no funcione o haya problemas con los datos que se están
recibido, póngase en contacto con
Steve Whitehead
- Correo electrónico Steve.whitehead@podiumsports.com
y
William Gibson
- Correo electrónico: William. gibson@pamediagroup.com
Esperamos que este documento de introducción le ayude a iniciarse en el uso de la API de Podio. En
Estamos encantados de tenerle a bordo y esperamos trabajar con usted en su caballo.
integración de carreras. Si tiene algún problema, no dude en ponerse en contacto con nosotros.
deseoso de comprender su experiencia con la API.
Apéndice A - Lista de países
Países disponibles en la API
REINO UNIDO
Irlanda
Japón
EE.UU.
Francia
Sudáfrica
Chile
Brasil
India
Hong Kong
Arabia Saudí
Uruguay
Apéndice B - Datos PUSH
Para los servicios con plazos críticos, nuestros datos PUSH permiten proporcionar pequeños fragmentos de datos a
clientes a integrar con su conjunto de datos generales.
Los siguientes datos están disponibles a través de PUSH
Evento : Condiciones (condiciones meteorológicas para la carrera, no para la reunión)
Evento : Dividendos (tote returns, CSF, tricast, trifecta, etc)
Entrante : Movimientos de apuestas (consejos sobre las grandes apuestas o comentarios sobre los movimientos de apuestas,
como "abierto a 28/1)
Participante : Close-up (comentario editorial posterior a la carrera en el que se describe el rendimiento de un caballo)
Participante : Peso del jockey (el peso solicitado por el jockey)
Entrante : No corredor (notificación de que un caballo ha pasado a ser no corredor)
Participante : Reincorporado (un no corredor ha sido reincorporado y ahora correrá)
Participante : Resultado (posición final del caballo)
Entrante : Espectáculos (actualizaciones de las probabilidades de los caballos)
Entrante : Precios de salida (confirmación del precio del caballo en la salida)
Participante : Retirado (un caballo ha sido retirado de la carrera)
Evento : Deducción (notificación de que se reducirán las devoluciones tras una retirada o
un cambio en el resultado)
Evento : Mercado reanudado (se ha reabierto un mercado de apuestas)
Evento : Mercado suspendido (se ha suspendido un mercado de apuestas)
Evento : Corrección de la hora de desconexión (se ha enviado una hora de desconexión actualizada)
Evento : Estado (un cambio en el estado de la carrera, por ejemplo, de inactiva, a baja, a
off, to finished)
Evento : Comisarios (hay una investigación de comisarios sobre el resultado de la carrera)
Evento : Tiempo ganador (el tiempo que tardó el ganador de la carrera desde el principio hasta el final)
Etapa : Condiciones (las condiciones de la reunión - el tiempo y el estado de
el suelo)
Etapa : Dividendos (dividendos relacionados con el cumplimiento de los resultados de nivel, es decir, el bote)
Etapa : Estado (estado de la reunión)
Apéndice C - Configuración de PUSH
El servicio PUSH está diseñado para complementar la API de descanso. En Raceday, un usuario puede elegir
para recibir actualizaciones a través de nuestro servicio de entrega AWS SNS PUSH.
Se ha diseñado para maximizar la velocidad de generación y entrega de los datos críticos del día de la carrera.
datos.
Mientras que un usuario podría optar por sondear la API varias veces por segundo para mantener su
PUSH ofrece la posibilidad de recibir únicamente las actualizaciones de los datos básicos.
en lugar de analizar cadenas de datos más largas.
Es importante tener en cuenta que un usuario tendrá que recuperar los datos de la tarjeta de la API REST.
No ofrecemos los datos completos de la tarjeta a través de PUSH para minimizar la carga de datos y los costes.
latencia.
En el Apéndice B encontrará más información sobre los formatos de los mensajes, pero es importante que
el valor actualizado (o nuevo) de los datos, y una cantidad suficiente de
datos de referencia para vincular los datos a la etapa, evento o participante correspondiente. No enviamos
el valor anterior.
En cualquier momento durante el Raceday, un cliente puede volver a utilizar la API REST para actualizar
su conjunto de datos, o volver a sincronizarlos con la versión formal de la verdad de Podio. Cada actualización de PUSH
se refleja en el conjunto de datos dentro de la API REST, y mediante el uso de puntos finales de revisión es
posible ver cuándo se generó una actualización
Configurar
La configuración del servicio PUSH está automatizada en Podio. Cuando le habilitamos para
PUSH, desencadenamos un proceso de creación de pila AWS que resulta en un SNS para que te conectes
a, donde podrá recuperar los mensajes. Este SNS reflejará su contrato
derechos sobre los datos, de modo que, por ejemplo, si se toman datos de GB pero no de Francia, sólo se
recibir datos relevantes de GB en el SNS.
Necesitamos su AWS IAM para permitirle acceder al entorno que creamos. Esto es
almacenados de forma segura en nuestra base de datos de derechos.
PUSH datos stubs ejemplo SHOWS
Nuestros servicios PUSH envían elementos de datos mínimos que están diseñados para actualizar
elementos del conjunto completo de datos que recibe
Espectáculos de apuestas
"body": “[{\”correlationId\”:\”4afbeb86-4aa6-483a-937a-
41d4a1ad6ed9\”,\”features\”:[\”BETTING_SHOWS\”],\”message\”:\”{\\\”id\\\”:\\\”4afa5384-b4bc-4951-
9ad3-1d35a6742cbc\\\”,\\\”type\\\”:\\\”event\\\”,\\\”entrants\\\”:[{\\\”id\\\”:\\\”30fb7908-3208-48bb-
9b59-
f9da8b9480ed\\\”,\\\”type\\\”:\\\”entrant\\\”,\\\”betting\\\”:{\\\”shows\\\”:[{\\\”marketnumber\\\”:1,\\\”
price\\\”:{\\\”decimal\\\”:200,\\\”denominator\\\”:1,\\\”numerator\\\”:200},\\\”created\\\”:\\\”2024-12-
12T17:50:46.618Z\"}]}"En este ejemplo
observe que el tipo de mensaje se declara como BETTING_SHOWS en el elemento features.
El primer dato relevante del mensaje es
\”message\”:\”{\\\”id\\\”:\\\”4afa5384-b4bc-4951-9ad3-1d35a6742cbc\\\”,\\\”type\\\”:\\\”event\\\”
Esto nos indica el UUID del evento al que se hace referencia, en este caso 4afa5384-b4bc-.
4951-9ad3-1d35a6742cbc.
({{$baseURL}}/events/4afa5384-b4bc-4951-9ad3-1d35a6742cbc)
que es el de las 18:00 en Chelmsford City el 12 de diciembre de 2025.
El siguiente dato relevante es
“entrants\\\”:[{\\\”id\\\”:\\\”30fb7908-3208-48bb-9b59-f9da8b9480ed\\\
({{$baseURL}}/entrants/30fb7908-3208-48bb-9b59-f9da8b9480ed)
Esto nos dice que el caballo que se devuelve es Pink Petunia en la carrera de arriba.
- Tenga en cuenta que una actualización puede abarcar a más de un participante.
El último dato clave es la carga útil real para el participante, que es
\\\”betting\\\”:{\\\”shows\\\”:[{\\\”marketnumber\\\”:1,\\\”price\\\”:{\\\”decimal\\\”:200,\\\”denominato
r\\\”:1,\\\”numerator\\\”:200}
Aquí puede ver que hemos enviado una actualización de las apuestas, y los nuevos programas (ambos decimales
y fraccional) están disponibles en el mensaje PUSH.
Cuando se envían varios participantes, los datos se envían en un participante / espectáculo / participante / espectáculo
como en este ejemplo
"body": “[{\”correlationId\”:\”18d28297-0211-4d4b-ac3f-
ae70ab8e7b74\”,\”features\”:[\”BETTING_SHOWS\”],\”message\”:\”{\\\”id\\\”:\\\”646f1b6a-f681-4334-
b54c-c2f50b7a144f\\\”,\\\”type\\\”:\\\”event\\\”,\\\”entrants\\\”:[{\\\”id\\\”:\\\”e3304cb4-9158-4b49-
8e78-
cacd60e8b370\\\”,\\\”type\\\”:\\\”entrant\\\”,\\\”betting\\\”:{\\\”shows\\\”:[{\\\”marketnumber\\\”:1,\\\”
price\\\”:{\\\”decimal\\\”:28,\\\”denominator\\\”:1,\\\”numerator\\\”:28},\\\”created\\\”:\\\”2024-12-
12T17:20:33.137Z\\\”}]}},{\\\”id\\\”:\\\”11bae700-c6e5-4987-a558-
67fac5e503b3\\\”,\\\”type\\\”:\\\”entrant\\\”,\\\”betting\\\”:{\\\”shows\\\”:[{\\\”marketnumber\\\”:1,\\\”
price\\\”:{\\\”decimal\\\”:150,\\\”denominator\\\”:1,\\\”numerator\\\”:150},\\\”created\\\”:\\\”2024-12-
12T17:20:33.137Z\\\”}]}}]}\”}]”,
Ejemplo de stubs de datos PUSH - STATUS
Este es un ejemplo de un cambio de estado, en este diciendo que la carrera ha terminado.
“[{\”correlationId\”:\”76b23408-2e0e-4612-b8f6-7c7116a27dbb\”,\”features\”:[],\”message\”:\”{\\\”id\\\”:\\\”c4c30487-1ee9-4864-886a11516985cefe\\\”,\\\”type\\\”:\\\”event\\\”,\\\”finished\\\”:\\\”2024-12-
12T17:03:32.995Z\\\”,\\\”status\\\”:\\\”finished\\\”,\\\”meta\\\”:{\\\”event:status:finished:timestamp\\\”:{\\\”code\\\”:\\\”event:status:finished:timestamp\\\”,\\\”value\\\”:\\\”2024-12-12T17:03:32.995Z\\\"}}}\"}]"
Para el mapeo, proporcionamos el id de evento de c4c30487-1ee9-4864-886a-11516985cefe que es el 5:00pm en Chelmsford el 12 de diciembre de 2024.
Este mensaje indica que la carrera se ha marcado como finalizada e incluye una marca de tiempo de cuándo ocurrió.
Este es el apagado para las 6:00pm en Chelmsford, que tiene un formato idéntico, excepto por el hecho de que el estado es 'apagado' , y la marca de tiempo asociada tiene un nombre diferente.
“[{\”correlationId\”:\”23b2508d-26a7-463a-8458-405c4b206830\”,\”features\”:[],\”message\”:\”{\\\”id\\\”:\\\”4afa5384-b4bc-4951-9ad3-1d35a6742cbc\\\”,\\\”type\\\”:\\\”event\\\”,\\\”offtime\\\”:\\\”2024-12-
12T18:01:17.117Z\\\”,\\\”status\\\”:\\\”off\\\”,\\\”meta\\\”:{\\\”event:status:off:timestamp\\\”:{\\\”code\\\”:\\\”event:status:off:timestamp\\\”,\\\”value\\\”:\\\”2024-12-12T18:01:17.117Z\\\"}}}\"}]"
PAGE data stubs ejemplo - GOING / WEATHER
Este ejemplo muestra una actualización del tiempo / ir de un evento.
[{\”correlationId\”:\”7ef44900-2c46-48dd-b289-4096bb0b7437\”,\”features\”:[],\”message\”:\”{\\\”id\\\”:\\\”c4c30487-1ee9-4864-886a11516985cefe\\\”,\\\”type\\\”:\\\”event\\\”,\\\”meta\\\”:{\\\”event:going\\\”:{\\\”code\\\”:\\\”event:going \\\”,\\\”value\\\”:\\\”standard\\\”},\\\”event:weather\\\”:{\\\”code\\\”:\\\”event:weather\\\”,\\\”value\\\”: \\\"Chubascos ligeros",
En este caso, el ID del evento es c4c30487-1ee9-4864-886a-11516985cefe, que son las 17:00 horas en Chelmsford el 12 de diciembre de 2024.
Este mensaje dice que el evento se ha cambiado a estándar, y el tiempo actualizado a lluvias ligeras.
Apéndice D - Filtros de campos
Estas funciones están más detalladamente documentadas en nuestro semáforo en la sección de parámetros de consulta de cada punto final, pero la API ofrece la posibilidad de devolver subconjuntos de los campos disponibles en un punto final, o de buscar cadenas de datos específicas dentro de la API.
Por ejemplo, en el punto final de los locales, puede que sólo le interesen los ID de las pistas y su nombre. Así, estableciendo una consulta 'fields' en POSTMAN a 'id,name' (no necesita las marcas de dicción) devolvería una lista de todas las sedes del sistema, con su UUID, y su nombre.
{{$baseURL}}/venues?fields=id,name
Esto devolverá una lista de todas las sedes del sistema.
Digamos, sin embargo, que queremos ver el país al que pertenece la pista, y ampliamos la lista de campos para incluirlo ({{$baseURL}}/venues?fields=id,name,country) = nos daremos cuenta de que estamos devolviendo TODOS los datos bajo el endpoint del país, lo que tiene una utilidad limitada.
Para limitar la devolución de datos en un endpoint anidado, debe asegurarse de que la codificación de URL está activada y, a continuación, enviar la siguiente cadena {{$baseURL}}/venues?fields=id,name,country{name,code}, que devolverá el nombre del circuito, el id del circuito, el país en el que se encuentra el circuito y la ubicación del circuito.
¿Desea filtrar las pistas de un determinado territorio? Actualmente puede buscar por el código de país o el countryid (el filtrado por nombre no está disponible)
{{$baseURL}}/venues?fields=id,name,country{name,code}&countrycodes=Reino Unido
Esta consulta devolverá el id y el nombre de todas las pistas almacenadas en el sistema para el Reino Unido
{{$baseURL}}/venues?fields=id,name,country{name,code,timezones,id}&countryids=b1 8b2ec5-f60e-4255-bf12-5c258c223d5d&pagesize=25
Así, esta consulta devolverá el ID y el nombre del lugar, así como el nombre, el código, la zona horaria y el ID del ID de la consulta (que resulta ser Inglaterra). Esto también establece el número de resultados devueltos en la consulta a 25 en lugar de los 10 por defecto.
ETAPAS - Ejemplos de filtros de campos
Etapas punto final
Sólo quiero ver el lugar, los nombres de las carreras y la hora de salida.
{{$baseURL}}/stages?fields=id,name,start,end,events[]{id,title,start}&from=2024-12-04&to=2024-12 04&countrycodes=UK&pagesize=10
devuelve (se trata de una respuesta parcial para abreviar)
"pagesize": 10,
"total": 4,
"filtros": {
"desde": "2024-12-04",
"to": "2024-12-04",
"fields": "id,name,start,end,events[]{id,title,start}",
"countrycodes": [
"REINO UNIDO"
]
},
"items": [
{
"id": “50adf989-535e-434d-b32a-e8d4c86d0252”,
"name": "Lingfield",
"start": “2024-12-04T11:20:00.000Z”,
"end": “2024-12-04T15:25:00.000Z”,
"eventos": [
{
"id": “80335f1d-0264-4339-88d1-15f7c643d799”,
"title": "Gana 1M con el Hándicap Goles de Oro de BetMGM",
"start": “2024-12-04T11:20:00.000Z”
},
{
"id": “c6b595d4-efbd-40d5-a635-446e9f0cf7e6”,
"title": "BetMGM: Es la hora del espectáculo en la guardería",
"start": “2024-12-04T11:50:00.000Z”
},
{
"id": “5b2fd2f7-946e-41ea-a33c-a28f0ec7f1d9”,
"title": "Gamble Responsibly At BetMGM/ EBF Fillies' Novice Stakes (GBB Race) (Div 1)",
"start": “2024-12-04T12:20:00.000Z”
Quiero ver la información de la etapa y sus metadatos asociados (como la marcha, el tiempo y la ventaja del sorteo) o la información devuelta en el meta stub no está disponible para filtrar.
{{$baseURL}}/stages?from=2024-12-04&to=2024-12-04&countrycodes=UK&pagesize=10&fields=id,name,start,end,meta
devuelve esta respuesta
"filtros": {
"desde": "2024-12-04",
"to": "2024-12-04",
"fields": "id,name,start,end,meta",
"countrycodes": [
"REINO UNIDO"
]
},
"items": [
{
"id": “50adf989-535e-434d-b32a-e8d4c86d0252”,
"name": "Lingfield",
"start": “2024-12-04T11:20:00.000Z”,
"end": “2024-12-04T15:25:00.000Z”,
"meta": {
"stage:going": {
"código": "stage:going",
"valor": "estándar"
},
"stage:weather": {
"código": "stage:weather",
"valor": "Mostly Cloudy"
},
"stage:drawadvantage": {
"code": "stage:drawadvantage",
"valor": "Poco efecto".
},
"stage:going:description": {
"code": "stage:going:description",
"valor": null
}
}
Quiero ver una lista de las carreras y su estado actual, y sus tiempos de salida y llegada
{{$baseURL}}/stages?from=2024-12-04&to=2024-12-04&countrycodes=UK&pagesize=10&query=Kempton&fields=id,name,start,end,events[]{start,status,finished, offtime}
"items": [
{
"id": “abd95869-59cc-496e-b9d6-bb48520b9fa6”,
"name": "Kempton",
"inicio": “2024-12-04T16:10:00.000Z”,
"end": “2024-12-04T20:10:00.000Z”,
"eventos": [
{
"inicio": “2024-12-04T16:10:00.000Z”,
"status": "HORSE_RACING_EVENT_WEIGHED_IN",
"finished": “2024-12-04T16:11:58.000Z”,
"offtime": “2024-12-04T16:10:29.000Z”
},
{
"inicio": “2024-12-04T16:40:00.000Z”,
"status": "HORSE_RACING_EVENT_WEIGHED_IN",
"finished": “2024-12-04T16:45:00.000Z”,
"offtime": “2024-12-04T16:43:46.000Z”
},
{
"inicio": “2024-12-04T17:10:00.000Z”,
"status": "HORSE_RACING_EVENT_WEIGHED_IN",
"finished": “2024-12-04T17:12:44.000Z”,
"offtime": “2024-12-04T17:11:30.000Z”
},
{
"inicio": “2024-12-04T17:40:00.000Z”,
"estado": "EVENT_RESULT",
"finished": “2024-12-04T17:43:56.000Z”,
"offtime": “2024-12-04T17:43:56.000Z”
},
{
"inicio": “2024-12-04T18:10:00.000Z”,
"status": "EVENT_OVERNIGHT",
"terminado": null,
"offtime": null
},
{
"start": “2024-12-04T18:40:00.000Z”,
"status": "EVENT_OVERNIGHT",
"terminado": null,
"offtime": null
},
{
"inicio": “2024-12-04T19:10:00.000Z”,
"status": "EVENT_OVERNIGHT",
"terminado": null,
"offtime": null
},
{
"start": “2024-12-04T19:40:00.000Z”,
"status": "EVENT_OVERNIGHT",
"terminado": null,
"offtime": null
},
{
"inicio": “2024-12-04T20:10:00.000Z”,
"status": "EVENT_OVERNIGHT",
"terminado": null,
"offtime": null
}
EVENTOS - Ejemplos de filtros de campo
Quiero ver una simple lista de corredores en cada carrera
{{$baseURL}}/events?from=04-12-2024&to=04-12-2024&fields=id,title,stageeventnumber,start,entrants[]{id,name,entrantnumber,stallnumber,status}&stageids=abd95869-59cc-496e-b9d6-bb48520b9fa6
Esto es para Kempton el 4 de diciembre de 2024
Nota: Se recomienda incluir un stageid en la consulta del evento para estar seguro de la reunión que se está consultando.
id": “6af09a35-bcae-4013-8168-9e2626bb6821”,
"title": "Unibet Zero% Mission Handicap",
"stageeventnumber": 8,
"start": “2024-12-04T19:40:00.000Z”,
"participantes": [
{
"id": “49cac5dd-d7c3-4f0a-88d8-99b445d848f0”,
"nombre": "Paseo Alpino",
"entrantnumber": 1,
"stallnumber": 12,
"status": "RUNNER"
},
{
"id": “8ee130ee-8d36-4614-afee-ec8347cae7e9”,
"Nombre": "Eton Blue",
"entrantnumber": 2,
"stallnumber": 5,
"status": "RUNNER"
},
{
"id": “643ace81-e7a4-4d9f-85ab-4b55871a444b”,
"Nombre": "Anochecer de Plata",
"entrantnumber": 3,
"stallnumber": 9,
"status": "RUNNER"
},
{
"id": “fbd27e5f-604c-491d-94b7-ed198716f308”,
"name": "Sgian Dubh",
"entrantnumber": 4,
"stallnumber": 6,
"status": "RUNNER"
},
{
"id": “3a45c37d-3966-494f-929b-9af650ff5e3d”,
"name": "Brisa de Bohemia",
"entrantnumber": 5,
"stallnumber": 7,
"status": "RUNNER"
},
{
"id": “5825afa8-89e9-4394-ac2c-1106527a7306”,
"Nombre": "Ángel de cumpleaños",
"entrantnumber": 6,
"stallnumber": 10,
"estado": "DOUBTFUL"
},
{
"id": “07d6b012-6458-4cd1-9972-c964487326f2”,
"Nombre": "Estrella Shamardal",
"entrantnumber": 7,
"stallnumber": 8,
"status": "RUNNER"
},
{
"id": “be54bc6e-ffc8-417c-ac60-74abadd6a3de”,
"Nombre": "Muchacho Liberado",
"entrantnumber": 8,
"stallnumber": 3,
"status": "RUNNER"
},
{
"id": “d4246b68-e4c2-4104-9684-e81117988e42”,
"name": "Alma torturada",
"entrantnumber": 9,
"stallnumber": 1,
"status": "RUNNER"
},
{
"id": “b505b52d-c6e7-43de-a5f0-f8934675401c”,
"Nombre": "Última Emperatriz",
"entrantnumber": 10,
"stallnumber": 11,
"status": "RUNNER"
},
{
"id": “6d1270da-0273-4a87-b256-098c6d0136a7”,
"Nombre": "Blue Collar",
"entrantnumber": 11,
"stallnumber": 4,
"status": "RUNNER"
},
{
"id": “fa1eea5f-806c-47be-8d5c-712db1ee8f04”,
"Nombre": "Meisterzinger",
"entrantnumber": 12,
"stallnumber": 2,
"status": "RUNNER"
}
]
Quiero recuperar fácilmente la descripción de la seda y la URL de recuperación para los corredores de una carrera
{{$baseURL}}/events?from=04-12-2024&to=04-12-2024&fields=id,title,stageeventnumber,start,entrants[]{id,name,associations[]{renditions{original{href, sourceText}}}}&stageids=abd95869-59cc-496e-b9d6-bb48520b9fa6
Respuesta parcial para abreviar
"filtros": {
"desde": "04-12-2024",
"to": "04-12-2024",
"campos":
"id,title,stageeventnumber,start,entrants[]{id,name,associations[]{renditions{original{href,sourceText}}
}}”,
"stageids": [
“abd95869-59cc-496e-b9d6-bb48520b9fa6”
]
},
"items": [
{
"id": “dbc87146-8263-4d1a-944c-f9e85e266fcb”,
"title": "Pruebe la nueva Acca de Unibet que aumenta el hándicap",
"stageeventnumber": 9,
"inicio": “2024-12-04T20:10:00.000Z”,
"participantes": [
{
"id": “977e3d61-fccd-4670-9c2d-44dc9f21f537”,
"Nombre": "Símbolo de Esperanza",
"asociaciones": [
{
"renditions": {
"original": {
"href": "https://bombyx.api.press.net/v1/bombyx/silk/f6d0989c-9f03-a14e-6498-8b4a1fe8cdfe",
"sourceText": "Amarillo, rombo azul oscuro, galones en las mangas, gorra azul oscuro, rombo amarillo".
}
}
}
]
},
{
"id": “168aae24-fb52-44e1-a5d9-9e3f8e45ffec”,
"Nombre": "Gran Bardo",
"asociaciones": [
{
"renditions": {
"original": {
"href": "https://bombyx.api.press.net/v1/bombyx/silk/d6b426c6-3851-ad96-ecbe4b3fb2c2d1c8",
"sourceText": "Amarillo, costuras rosas, mangas y gorro amarillos"
}
}
}
]
},
{
"id": “b25186df-3e39-4fb2-ac4b-8728f23195e5”,
"Nombre": "Brunel Charm",
"asociaciones": [
{
"renditions": {
"original": {
"href": “https://bombyx.api.press.net/v1/bombyx/silk/0fb840c3-41e0-36d5-da47-7a656cc9b39b”,
"sourceText": "Granate, estrellas verde esmeralda, mangas y estrella en la gorra"
}
}
}
]
},
ENTRANTES - Ejemplos de filtros de campos
Quiero ver cada actualización de apuesta recibida por un corredor en una carrera
{{$baseURL}}/entrants/dd06959e-4090-45d8-91f7-42d12a12baf2?pagesize=25&fields=id,name,betting
Respuesta (devuelve la previsión de precios, espectáculos y SP)
{
"id": “dd06959e-4090-45d8-91f7-42d12a12baf2”,
"Nombre": "Gacela de Arena",
"apuestas": {
"previsión": {
"precio": {
"decimal": 6,
"numerador": 6,
"denominador": 1
}
},
"espectáculos": [
{
"número de mercado": 1,
"creado": “2024-12-04T16:02:34.000Z”,
"precio": {
"decimal": 16,
"numerador": 16,
"denominador": 1
}
},
{
"número de mercado": 1,
"creado": “2024-12-04T16:00:33.000Z”,
"precio": {
"decimal": 14,
"numerador": 14,
"denominador": 1
}
},
{
"número de mercado": 1,
"creado": “2024-12-04T16:00:00.000Z”,
"precio": {
"decimal": 12,
"numerador": 12,
"denominador": 1
}
},
{
"número de mercado": 1,
"creado": “2024-12-04T16:05:57.000Z”,
"precio": {
"decimal": 18,
"numerador": 18,
"denominador": 1
}
},
{
"número de mercado": 1,
"creado": “2024-12-04T16:06:33.000Z”,
"precio": {
"decimal": 16,
"numerador": 16,
"denominador": 1
}
},
{
"número de mercado": 1,
"creado": “2024-12-04T16:06:54.000Z”,
"precio": {
"decimal": 18,
"numerador": 18,
"denominador": 1
}
},
{
"número de mercado": 1,
"creado": “2024-12-04T16:09:46.000Z”,
"precio": {
"decimal": 20,
"numerador": 20,
"denominador": 1
}
}
],
"startingprice": {
"precio": {
"decimal": 20,
"numerador": 20,
"denominador": 1
},
"marketposition": nulo,
"marketcount": null
}
}
}