GET /v1/results
Todos los sorteos oficiales de un día.
Parámetros
date | fecha | El día, en la fecha local de los sorteos. |
|---|
Responde V1DayEstados posibles 200400401403429500
Todo lo que responde /v1: endpoints, parámetros, objetos y errores, tomados del documento OpenAPI del API.
$RC_API/v1/… Cada solicitud va a esa dirección seguida de la ruta. La dirección se publica con el registro.Authorization: Bearer <token> Cada solicitud lleva tu token en esa cabecera. Los tokens llegan con el registro./v1/resultsTodos los sorteos oficiales de un día.
date | fecha | El día, en la fecha local de los sorteos. |
|---|
Responde V1DayEstados posibles 200400401403429500
/v1/lotteriesLas loterías disponibles, con los días en que sortean.
Responde V1LotteriesEstados posibles 200401429500
/v1/lotteries/{id}/resultsEl historial de una lotería entre dos fechas, un día por fecha.
id | entero | El id de la lotería, de /v1/lotteries. |
|---|---|---|
from | fecha | Primer día del rango, incluido. |
to | fecha | Último día del rango, incluido. Hasta 400 días desde from, dentro del historial de tu plan. |
Responde V1LotteryResultsEstados posibles 200400401403404429500
/v1/coverageEl primer y el último día con resultados oficiales.
Responde V1CoverageEstados posibles 200401404429500
V1DayLos sorteos oficiales de un día.
| Campo | Tipo | Descripción |
|---|---|---|
date | fecha | El día, en la fecha local de los sorteos. |
generatedAt | fecha y hora UTC | Cuándo se generó la respuesta. |
draws | lista de V1Draw | Los sorteos oficiales que ya ves en tu plan. |
V1DrawUn sorteo oficial.
| Campo | Tipo | Descripción |
|---|---|---|
id | texto | Identificador del sorteo en ese día. |
lotteryId | entero | El id de su lotería. |
lottery | texto | El nombre de la lotería. |
sortition | texto | El nombre del sorteo. |
country | uno de unitedStates, dominicanRepublic, haiti, anguilla, sintMaarten, honduras, elSalvador, bonaire, panama | El país de la lotería. |
date | fecha | El día local del sorteo. |
drawAt | fecha y hora UTC | La hora del sorteo, en UTC. |
numbers | lista de V1Number | Los números que salieron, en orden. |
V1NumberUn número del resultado.
| Campo | Tipo | Descripción |
|---|---|---|
field | uno de first, second, third, pickTwo, pickThree, pickFour, pickFive, pickFourSecond, pickFourThird | Qué posición o juego es: first, second y third en las loterías dominicanas; pickTwo a pickFive en las americanas. |
display | texto | El número tal como se publica, con ceros a la izquierda. |
V1LotteriesLas loterías del API.
| Campo | Tipo | Descripción |
|---|---|---|
lotteries | lista de V1Lottery | Cada lotería disponible. |
V1LotteryUna lotería.
| Campo | Tipo | Descripción |
|---|---|---|
id | entero | Su id, el que usan las demás rutas. |
name | texto | Su nombre. |
slug | texto | Su nombre para URLs. |
schedule | lista de entero | Los días de la semana en que sortea: 0 es domingo y 6, sábado. |
V1LotteryResultsEl historial de una lotería.
V1CoverageEl rango de fechas con resultados oficiales.
| Campo | Tipo | Descripción |
|---|---|---|
earliest | fecha | El primer día con resultados. |
latest | fecha | El último día con resultados. |
ErrorResponseEl cuerpo de toda respuesta de error.
| Campo | Tipo | Descripción |
|---|---|---|
erroropcional | uno 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.unauthorized | El código del error. |
paramsopcional | objeto de textos | Detalles, como el parámetro que falló. |
Todo error responde con un objeto ErrorResponse y el estado HTTP que corresponda.
| Código | Descripción |
|---|---|
internal | 500 · Error del servidor. Vuelve a intentarlo. |
method.not_allowed | 405 · Esa ruta solo acepta GET. |
not_found | 404 · La lotería o la ruta no existe. |
request.invalid | 400 · No se pudo leer la solicitud. |
request.param.invalid | 400 · Un parámetro no es válido; params.name dice cuál. |
request.too_large | 413 · La solicitud es demasiado grande. |
v1.plan_history | 403 · La fecha está fuera del historial de tu plan. |
v1.quota_exceeded | 429 · Llegaste al límite del mes de tu plan. |
v1.rate_limited | 429 · Llegaste al límite por minuto de tu plan. |
v1.unauthorized | 401 · 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.
| Plan | Por minuto | Al mes | Retraso | Historial |
|---|---|---|---|---|
| Básico | 10 | 1,000 | Con 15 min de retraso | 30 días |
| Pro | 60 | 50,000 | Con 5 min de retraso | 400 días |
| Ultra | 300 | 500,000 | Tiempo real | 400 días |
| Mega | 1,000 | 3,000,000 | Tiempo real | 400 días |
El contrato completo de /v1, para generar tu cliente.
Descargar openapi.yaml