Documentación de la API de resultados de casino en vivo

Aquí está lo que vale para todas las APIs, como autenticación, prueba, límites y errores, y cada API tiene su propia página con los endpoints, los parámetros y el significado de cada campo de la respuesta.

APIs

Elige la API para ver cómo responde. Todas están en https://api.lynxmetrics.com/v1/ seguido del slug de la API, y las respuestas vienen dentro de data, con fechas en UTC.

Autenticación

Cada clave vale para una sola API y empieza con sk-lynx, así que crea en el panel una clave para cada API que uses y envíala en el encabezado x-api-key, cambiando {api} por su slug. Una clave de una API que llama a otra recibe key_wrong_api. En el panel cada clave aparece enmascarada, con un botón para copiarla cuando quieras y otro para rotarla, que cambia la clave por una nueva y hace que la anterior deje de responder en instantes.

curl https://api.lynxmetrics.com/v1/{api}/latest \
  -H "x-api-key: TU_CLAVE"

Tiempo real

Hay tres formas de recibir cada ronda, de la más rápida a la más simple. Las tres entregan el mismo objeto, así que puedes empezar por la más simple y cambiar después sin tocar el resto del código.

  1. El /stream de cada API: una conexión abierta que recibe la ronda en el instante en que cierra. Solo abrirla cuenta en el límite por minuto. Es lo recomendado para lo que corre todo el día.
  2. /latest?wait=20: una solicitud normal que solo responde cuando cierra la próxima ronda, o después de 20 segundos. Es una solicitud por ronda, sin mantener una conexión abierta, y sirve para cualquier lenguaje que haga un GET.
  3. /latest consultado cada cierto tiempo: funciona, pero cada consulta cuenta en el límite por minuto y la ronda llega con el retraso de tu intervalo. Envía el ETag en if-none-match para recibir 304 cuando nada cambió.

El código listo de cada una, en Python, Node.js y PHP, está en la documentación de cada API, en la sección Ejemplos de código. Para saber si una mesa está entregando rondas ahora, mira la página de estado.

Prueba y suscripción

Cada suscripción es una API con un identificador fijo como coral-7k2m, y la prueba también. Con el correo confirmado, creas en el panel la prueba de cada API, que queda en una API de prueba y te da una clave que funciona durante trial.durationMinutes minutos con los límites de trial.plan y luego responde trial_expired. Esos minutos empiezan a contar en la primera llamada de la clave, no cuando la creaste, así que ella espera sin vencer hasta que integres. La siguiente prueba de la misma API se habilita trial.cooldownHours horas después del fin de la anterior, con el mismo identificador y una clave nueva, y quien ya tiene esa API suscrita no necesita prueba. Al suscribir la API de la prueba, pasa a ser de pago con el mismo identificador y el mismo uso, y la clave de prueba pasa a ser una clave normal del plan, sin vencimiento, así que la integración no cambia. Puedes suscribir la misma API todas las veces que quieras, cada suscripción con su nombre, su plan, sus claves, su límite por minuto y su uso, y cada clave funciona mientras su suscripción esté activa. Cuando termina, las claves responden subscription_required, y con el pago pendiente siguen 3 días mientras Stripe intenta cobrar de nuevo y luego responden payment_pending hasta que entre el pago.

Límites

Los límites vienen del plan de la suscripción a la que pertenece la clave, o del plan de la prueba mientras la clave de prueba es válida: el máximo de limit, el tamaño de sample y cuántos días atrás puede ir before. Un valor por encima del máximo se reduce al máximo, el uso se cuenta por suscripción y los números de cada plan están en la documentación de cada API. Cada plan también tiene un límite de solicitudes por minuto, que vale para cada suscripción sumando todas sus claves, así que quien suscribe la misma API dos veces tiene dos límites separados, y la prueba usa el límite de su plan. Puedes hacer una ráfaga de hasta ese número de una vez, y el saldo se recupera poco a poco a lo largo del minuto. Cada respuesta de una clave aceptada trae X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset, que indica en cuántos segundos el saldo vuelve completo; los errores que llegan antes del límite, como clave inválida, API equivocada y suscripción terminada, no traen esos encabezados, y quien pasa del límite recibe 429 rate_limited con Retry-After, que indica cuántos segundos esperar.

Errores

Cada error trae un código que nunca cambia y un mensaje en el idioma de tu cuenta.

{
  "error": {
    "code": "key_wrong_api",
    "message": "Esta clave es de otra API."
  }
}
  • bad_request400Un parámetro vino con formato inválido, como una fecha de before que no es ISO 8601.
  • unauthorized401Clave ausente, inválida o revocada.
  • key_wrong_api403La clave es de otra API.
  • trial_expired403La clave de prueba venció, así que suscribe la API de la prueba en el panel y la misma clave vuelve a funcionar.
  • subscription_required403La suscripción a la que pertenece la clave no está activa.
  • payment_pending402El pago de la suscripción a la que pertenece la clave lleva más de 3 días pendiente.
  • plan_limit403La solicitud va más allá de lo que permite tu plan en esta API, como un historial más antiguo.
  • not_found404Esa API no existe o todavía no está disponible.
  • route_not_found404Esa ruta no existe.
  • rate_limited429Hubo demasiadas solicitudes en poco tiempo, así que espera los segundos de Retry-After y vuelve a intentarlo.
  • too_many_streams429La API tiene todas las conexiones de /stream ocupadas ahora, así que inténtalo de nuevo en unos instantes. Pasarte del número de conexiones de tu plan no da este error: la conexión más antigua de la clave se cierra y la nueva ocupa su lugar.
  • internal_error500Error inesperado de nuestro lado.
  • upstream_error502No pudimos leer los datos ahora, inténtalo de nuevo en un momento.
  • timeout504La solicitud tardó más de 10 segundos, inténtalo de nuevo en un momento.