← API de resultados

Documentación del API

Todo lo que responde /v1: endpoints, parámetros, objetos y errores, tomados del documento OpenAPI del API.

Introducción

Dirección base
$RC_API/v1/… Cada solicitud va a esa dirección seguida de la ruta. La dirección se publica con el registro.
Autenticación Pronto
Authorization: Bearer <token> Cada solicitud lleva tu token en esa cabecera. Los tokens llegan con el registro.
Fechas y horas
Una fecha (AAAA-MM-DD) es el día local de cada sorteo: nunca conviertes zonas horarias. Las horas, como drawAt, van en UTC, en formato ISO 8601.
Respuestas
JSON en UTF-8. Solo se cobran las respuestas exitosas (2xx).

Endpoints

GET /v1/results

Todos los sorteos oficiales de un día.

Parámetros

datefecha· consulta · obligatorioEl día, en la fecha local de los sorteos.

Responde V1DayEstados posibles 200400401403429500

GET /v1/lotteries

Las loterías disponibles, con los días en que sortean.

Parámetros

Sin parámetros.

Responde V1LotteriesEstados posibles 200401429500

GET /v1/lotteries/{id}/results

El historial de una lotería entre dos fechas, un día por fecha.

Parámetros

identero· ruta · obligatorioEl id de la lotería, de /v1/lotteries.
fromfecha· consulta · obligatorioPrimer día del rango, incluido.
tofecha· consulta · obligatorioÚltimo día del rango, incluido. Hasta 400 días desde from, dentro del historial de tu plan.

Responde V1LotteryResultsEstados posibles 200400401403404429500

GET /v1/coverage

El primer y el último día con resultados oficiales.

Parámetros

Sin parámetros.

Responde V1CoverageEstados posibles 200401404429500

Objetos

V1Day

Los sorteos oficiales de un día.

CampoTipoDescripción
datefechaEl día, en la fecha local de los sorteos.
generatedAtfecha y hora UTCCuándo se generó la respuesta.
drawslista de V1DrawLos sorteos oficiales que ya ves en tu plan.

V1Draw

Un sorteo oficial.

CampoTipoDescripción
idtextoIdentificador del sorteo en ese día.
lotteryIdenteroEl id de su lotería.
lotterytextoEl nombre de la lotería.
sortitiontextoEl nombre del sorteo.
countryuno de unitedStates, dominicanRepublic, haiti, anguilla, sintMaarten, honduras, elSalvador, bonaire, panamaEl país de la lotería.
datefechaEl día local del sorteo.
drawAtfecha y hora UTCLa hora del sorteo, en UTC.
numberslista de V1NumberLos números que salieron, en orden.

V1Number

Un número del resultado.

CampoTipoDescripción
fielduno de first, second, third, pickTwo, pickThree, pickFour, pickFive, pickFourSecond, pickFourThirdQué posición o juego es: first, second y third en las loterías dominicanas; pickTwo a pickFive en las americanas.
displaytextoEl número tal como se publica, con ceros a la izquierda.

V1Lotteries

Las loterías del API.

CampoTipoDescripción
lotterieslista de V1LotteryCada lotería disponible.

V1Lottery

Una lotería.

CampoTipoDescripción
identeroSu id, el que usan las demás rutas.
nametextoSu nombre.
slugtextoSu nombre para URLs.
schedulelista de enteroLos días de la semana en que sortea: 0 es domingo y 6, sábado.

V1LotteryResults

El historial de una lotería.

CampoTipoDescripción
lotteryV1LotteryLa lotería consultada.
dayslista de V1DayCada día del rango, con sus sorteos.

V1Coverage

El rango de fechas con resultados oficiales.

CampoTipoDescripción
earliestfechaEl primer día con resultados.
latestfechaEl último día con resultados.

ErrorResponse

El cuerpo de toda respuesta de error.

CampoTipoDescripción
erroropcionaluno de internal, method.not_allowed, not_found, request.invalid, request.param.invalid, request.too_large, v1.plan_history, v1.quota_exceeded, v1.rate_limited, v1.unauthorizedEl código del error.
paramsopcionalobjeto de textosDetalles, como el parámetro que falló.

Errores

Todo error responde con un objeto ErrorResponse y el estado HTTP que corresponda.

CódigoDescripción
internal500 · Error del servidor. Vuelve a intentarlo.
method.not_allowed405 · Esa ruta solo acepta GET.
not_found404 · La lotería o la ruta no existe.
request.invalid400 · No se pudo leer la solicitud.
request.param.invalid400 · Un parámetro no es válido; params.name dice cuál.
request.too_large413 · La solicitud es demasiado grande.
v1.plan_history403 · La fecha está fuera del historial de tu plan.
v1.quota_exceeded429 · Llegaste al límite del mes de tu plan.
v1.rate_limited429 · Llegaste al límite por minuto de tu plan.
v1.unauthorized401 · Falta el token o no es válido.

Las respuestas 429 llevan la cabecera Retry-After: los segundos que debes esperar antes de volver a llamar, al menos 1.

Límites por plan

PlanPor minutoAl mesRetrasoHistorial
Básico101,000Con 15 min de retraso30 días
Pro6050,000Con 5 min de retraso400 días
Ultra300500,000Tiempo real400 días
Mega1,0003,000,000Tiempo real400 días

OpenAPI

El contrato completo de /v1, para generar tu cliente.

Descargar openapi.yaml